std::wcstof, std::wcstod, std::wcstold

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

ヌル終端ワイド文字列

関数
文字の分類
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
文字操作
towlower towupper	towctrans wctrans
数値フォーマットへの変換
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
文字列操作
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
文字列検査
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
配列操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset
型 wctrans_t wctype_t wint_t	マクロ WCHAR_MIN WCHAR_MAX WEOF

 

ヘッダ <cwchar> で定義
float       wcstof( const wchar_t* str, wchar_t** str_end );		(C++11以降)
double      wcstod( const wchar_t* str, wchar_t** str_end );
long double wcstold( const wchar_t* str, wchar_t** str_end );		(C++11以降)

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

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

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

• (任意)プラスまたはマイナスの記号
• 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浮動小数点値となる。

(C++11以降)

• 現在インストールされているC ロケールで受け入れられる可能性のあるその他の表現。

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

パラメータ

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

戻り値

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

例

このコードを実行

#include <cerrno>
#include <clocale>
#include <cwchar>
#include <iostream>
#include <string>
 
int main()
{
    const wchar_t* p = L"111.11 -2.22 0X1.BC70A3D70A3D7P+6 -Inf 1.18973e+4932zzz";
    wchar_t* end;
    std::wcout << "Parsing L\"" << p << "\":\n";
    for (double f = std::wcstod(p, &end); p != end; f = std::wcstod(p, &end))
    {
        std::wcout << "  '" << std::wstring(p, end-p) << "' -> ";
        p = end;
        if (errno == ERANGE)
        {
            std::wcout << "range error, got ";
            errno = 0;
        }
        std::wcout << f << '\n';
    }
 
    if (std::setlocale(LC_NUMERIC, "de_DE.utf8"))
    {
        std::wcout << L"With de_DE.utf8 locale:\n";
        std::wcout << L"  '123.45' -> " << std::wcstod(L"123.45", 0) << L'\n';
        std::wcout << L"  '123,45' -> " << std::wcstod(L"123,45", 0) << L'\n';
    }
}

出力

Parsing L"111.11 -2.22 0X1.BC70A3D70A3D7P+6 -Inf 1.18973e+4932zzz":
  '111.11' -> 111.11
  ' -2.22' -> -2.22
  ' 0X1.BC70A3D70A3D7P+6' -> 111.11
  ' -Inf' -> -inf
  ' 1.18973e+4932' -> range error, got inf
With de_DE.utf8 locale:
  '123.45' -> 123
  '123,45' -> 123.45

関連項目

strtofstrtodstrtold	バイト文字列を浮動小数点値に変換する (関数)
C のドキュメント (wcstof)