std::stof, std::stod, std::stold

 

C++

コンパイラサポート

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

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

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

言語サポートライブラリ

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

診断ライブラリ

メモリ管理ライブラリ

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

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

コンテナライブラリ

イテレータライブラリ

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

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

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

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

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

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

文字列ライブラリ

クラス

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

メンバ関数 basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator 要素アクセス basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) イテレータ basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) 検索 basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of

変更 basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap 容量 basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) 操作 basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

定数 basic_string::npos 非メンバ関数 operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline 比較 operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20まで)(C++20まで)(C++20まで)(C++20まで)(C++20まで)(C++20) 数値変換 stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) リテラル operator""s (C++14) ヘルパークラス hash<std::basic_string> (C++11) 推論ガイド (C++17)

 

ヘッダ <string> で定義
float       stof ( const std::string& str, std::size_t* pos = nullptr );	(1)	(C++11以降)
float       stof ( const std::wstring& str, std::size_t* pos = nullptr );	(2)	(C++11以降)
double      stod ( const std::string& str, std::size_t* pos = nullptr );	(3)	(C++11以降)
double      stod ( const std::wstring& str, std::size_t* pos = nullptr );	(4)	(C++11以降)
long double stold( const std::string& str, std::size_t* pos = nullptr );	(5)	(C++11以降)
long double stold( const std::wstring& str, std::size_t* pos = nullptr );	(6)	(C++11以降)

str の浮動小数点値を解釈します。

それぞれ char* (1,3,5) または wchar_t* (2,4,6) 型の、変換関数内部のポインタを char* または wchar_t* とします。

1) std::strtof(str.c_str(), &ptr) を呼び出します。

2) std::wcstof(str.c_str(), &ptr) を呼び出します。

3) std::strtod(str.c_str(), &ptr) を呼び出します。

4) std::wcstod(str.c_str(), &ptr) を呼び出します。

5) std::strtold(str.c_str(), &ptr) を呼び出します。

6) std::wcstold(str.c_str(), &ptr) を呼び出します。

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

• 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 ロケールで受け入れられる可能性のあるその他の表現。

もし pos がヌルポインタでない場合、ptr は str.c_str() 内の最初の未変換文字のアドレスを受け取り、その文字のインデックスが計算されて *pos に格納され、変換された文字数を示します。

パラメータ

str	-	変換する文字列
pos	-	処理された文字数を格納する整数へのアドレス

戻り値

指定された浮動小数点型に変換された文字列。

例外

std::invalid_argument: 変換が実行できなかった場合。

std::out_of_range: 変換された値が結果型の範囲外である場合、または基になる関数（std::strtof、std::strtod、またはstd::strtold）が errno を ERANGE に設定した場合。

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 2009	C++11	std::out_of_range は、変換された 値が結果型の範囲外になる場合、スローされません。	スローします。
LWG 2403	C++11	stof が std::strtod または std::wcstod を呼び出す	stof が std::strtof または std::wcstof を呼び出す

関連項目

stoistolstoll (C++11)(C++11)(C++11)	文字列を符号付き整数に変換する (function)
stoulstoull (C++11)(C++11)	文字列を符号なし整数に変換する (function)
from_chars (C++17)	文字シーケンスを整数値または浮動小数点数値に変換する (関数)