wcstof, wcstod, wcstold

ヘッダー `<wchar.h>` で定義
float wcstof( const wchar_t* restrict str, wchar_t** restrict str_end );		(C99以降)
double wcstod( const wchar_t* str, wchar_t** str_end );		(C95 以降) (C99まで)
double wcstod( const wchar_t* restrict str, wchar_t** restrict str_end );		(C99以降)
long double wcstold( const wchar_t* restrict str, wchar_t** restrict str_end );		(C99以降)

strが指すワイド文字列の浮動小数点値を解釈します。

関数は、最初の非空白文字が見つかるまで、空白文字（iswspaceによって決定される）をすべて破棄します。次に、有効な浮動小数点表現を形成できるだけ多くの文字を取り込み、それらを浮動小数点値に変換します。有効な浮動小数点値は、次のいずれかになります。

10進数浮動小数点表記。以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
十進数の数字の空でないシーケンス。必要に応じて小数点文字（現在の C ロケールによって決定される）を含む（仮数部を定義する）。
(任意)eまたはE、それにオプションのマイナスまたはプラス記号と10進数字の非空のシーケンスが続く（ $10$ を底とする指数を定義する）。

16進数浮動小数点表記。以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
0xまたは0X
16進数の数字の空でないシーケンス。必要に応じて小数点文字（現在の C ロケールによって決定される）を含む（仮数部を定義する）。
(任意)pまたはP、それにオプションのマイナスまたはプラス記号と10進数字の非空のシーケンスが続く（ $2$ を底とする指数を定義する）。

無限大表記。以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
INFまたはINFINITY（大文字・小文字を区別しない）。

非数（NaN）表記。以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
NANまたはNAN(char_sequence )（NAN部分の大文字・小文字は区別しない。*char_sequence*は数字、ラテン文字、アンダースコアのみを含むことができる。結果はクワイエットNaN浮動小数点値となる。

(C99以降)

現在インストールされている C ロケールによって受け入れられる可能性のあるその他の任意の式。

str_endが指すポインタは、解釈された最後の文字の次のワイド文字を指すように設定されます。str_endがヌルポインタの場合、無視されます。

成功した場合、strの内容に対応する浮動小数点値が返されます。変換された値が対応する戻り値の型の範囲を超える場合、範囲エラーが発生し、HUGE_VAL、HUGE_VALF、またはHUGE_VALLが返されます。変換が実行できない場合、0が返されます。

[編集] 例

このコードを実行

#include <errno.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    const wchar_t* p = L"111.11 -2.22 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz";
    printf("Parsing L\"%ls\":\n", p);
    wchar_t* end;
    for (double f = wcstod(p, &end); p != end; f = wcstod(p, &end))
    {
        printf("'%.*ls' -> ", (int)(end-p), p);
        p = end;
        if (errno == ERANGE){
            printf("range error, got ");
            errno = 0;
        }
        printf("%f\n", f);
    }
}

出力

Parsing L"111.11 -2.22 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz":
'111.11' -> 111.110000
' -2.22' -> -2.220000
' 0X1.BC70A3D70A3D7P+6' -> 111.110000
'  1.18973e+4932' -> range error, got inf

[編集] 参考文献

C23標準 (ISO/IEC 9899:2024)

7.29.4.1.1 wcstod、wcstof、およびwcstold関数（p: TBD）

C17標準 (ISO/IEC 9899:2018)

7.29.4.1.1 wcstod、wcstof、およびwcstold関数（p: TBD）

C11標準 (ISO/IEC 9899:2011)

7.29.4.1.1 wcstod、wcstof、およびwcstold関数（p: 426-428）

C99標準 (ISO/IEC 9899:1999)

7.24.4.1.1 wcstod、wcstof、およびwcstold関数（p: 372-374）

[編集] 関連項目

strtofstrtodstrtold (C99)(C99)	バイト文字列を浮動小数点値に変換する (関数) [編集]
C++ ドキュメント wcstof, wcstod, wcstold

コンパイラサポート
言語
ヘッダー
型サポート
プログラムユーティリティ
可変長引数関数のサポート
エラーハンドリング
動的メモリ管理
文字列ライブラリ
アルゴリズム
数値
日付と時刻のユーティリティ
入出力サポート
ローカライゼーションサポート
並行処理サポート (C11)
技術仕様
シンボルインデックス

cppreference.com

名前空間

変種

表示

操作

wcstof, wcstod, wcstold

目次

[編集] パラメータ

[編集] 戻り値

[編集] 例

[編集] 参考文献

[編集] 関連項目

ナビゲーション

ツールボックス

str	-	解釈されるヌル終端ワイド文字列へのポインタ
str_end	-	ワイド文字へのポインタへのポインタ。