OpenVMS マニュアル

wcstod

指定されたワイド文字列を倍精度の数値に変換します。

形式

#include <wchar.h>

double wcstod (const wchar_t *nptr, wchar_t **endptr);

引数

nptr

倍精度の数値に変換するワイド文字列へのポインタ。

endptr

関数が，スキャンを終了させた最初の認識不可能なワイド文字のアドレスを格納できるオブジェクトのアドレス。 endptr が NULL ポインタである場合，最初の認識不可能なワイド文字のアドレスは保存されません。

説明

wcstod関数は，オプションとして空白文字 ( iswspaceの定義に従う) のシーケンスを，さらにオプションのプラスまたはマイナス記号を，さらにオプションとして基数文字を含んだ数字のシーケンスを，さらにオプションの文字 (e または E) を，最後にオプションの符号付きの整数を認識します。最初の認識不可能な文字が現れた時点で，変換は終了します。

文字列は，浮動小数点定数を解釈するときに使用されるのと同じ規則によって解釈されます。

基数文字は，プログラムの現在のロケール (カテゴリ LC_NUMERIC) によって定義されています。

この関数は，変換後の値を返します。 wcstodでは，オーバフローは次のように処理されます。

• 正しい値がオーバフローを引き起こす場合には， ( 値の符号に従ってプラスまたはマイナス記号が付いた ) HUGE_VAL が返され， errnoは ERANGE に設定される。

• 正しい値がアンダフローを引き起こす場合には，0 が返され， errnoは EINVAL に設定される。

文字列が認識不可能なワイド文字で始まる場合， *endptr は nptr に設定され，値 0 が返されます。

戻り値

x	変換された文字列。
0	変換が実行できなかったことを示します。 errno は以下のいずれかに設定されます。 EINVAL---変換は実行できなかった。 ERANGE---値はアンダフローを引き起こす。 ENOMEM---内部変換バッファ用のメモリが足りなかった。
±HUGE_VAL	オーバフローが発生しました。 errno は ERANGE に設定されます。