std::stoi, std::stol, std::stoll

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

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

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

メンバ関数 basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator 要素アクセス basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) 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::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

操作 basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap 検索 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::npos

非メンバ関数 operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) 入出力 operator<<operator>> getline 比較 operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20) 数値変換 (C++11) stoistolstoll stoulstoull stofstodstold to_string to_wstring ヘルパークラス hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)(C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++20)(C++20)(C++20)(C++20)(C++20) 推定ガイド(C++17)

 

ヘッダ <string> で定義
int       stoi(conststd::string& str, std::size_t* pos =0, int base =10); int       stoi(conststd::wstring& str, std::size_t* pos =0, int base =10);	(1)	(C++11以上)
long      stol(conststd::string& str, std::size_t* pos =0, int base =10); long      stol(conststd::wstring& str, std::size_t* pos =0, int base =10);	(2)	(C++11以上)
longlong stoll(conststd::string& str, std::size_t* pos =0, int base =10); longlong stoll(conststd::wstring& str, std::size_t* pos =0, int base =10);	(3)	(C++11以上)

文字列 str 内の符号付き整数値を解釈します。

1)std::strtol(str.c_str(), &ptr, base) または std::wcstol(str.c_str(), &ptr, base) を呼びます。

2)std::strtol(str.c_str(), &ptr, base) または std::wcstol(str.c_str(), &ptr, base) を呼びます。

3)std::strtoll(str.c_str(), &ptr, base) または std::wcstoll(str.c_str(), &ptr, base) を呼びます。

最初の非ホワイトスペース文字が見つかるまで、あらゆるホワイトスペース文字を破棄します (ホワイトスペースは isspace() を呼ぶことによって識別されます)。 その後、有効な　base 進数の整数表現を形成する文字を可能な限り多く読み込み、それを整数値に変換します。 有効な整数値は以下のように構成されます。

• (オプション) 正または負の符号
• (オプション) 8進数を表す接頭辞 0 (基数が 8 または ​0​ の場合のみ)
• (オプション) 16進数を表す接頭辞 0x または 0X (基数が 16 または ​0​ の場合のみ)
• 数字の並び

基数に対する有効な値の集合は {0,2,3,...,36} です。 2進数の整数に対する有効な数字の集合は {0,1} で、3進数に対しては {0,1,2} で、以下同様です。 10 より大きな基数に対しては、有効な数字にアルファベット文字が含まれます。11進数用の Aa から始まり、36進数用の Zz までです。 大文字小文字の違いは無視されます。

現在設定されている C のロケールによって、追加の数値形式が受理されるかもしれません。

base の値が ​0​ の場合、基数は自動検出されます。 接頭辞が 0 であれば8進数、 0x または 0X であれば16進数、そうでなければ10進数です。

入力列の一部に負の符号があった場合、結果の型で単項マイナス演算子によって行われたかのように、その数字列から計算された数値の符号が反転されます。

pos がヌルポインタでなければ、ポインタ ptr (変換関数の内部的な変数) が str.c_str() 内の最初の変換されなかった文字のアドレスを受け取り、その文字のインデックスが計算されて *pos に格納されます。 これは変換によって処理された文字数になります。

引数

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

戻り値

str の内容に対応する整数値。

例外

• 変換が行えなかった場合、 std::invalid_argument。
• 変換後の値が結果の型の範囲外となった場合、またはベースとなる関数 (std::strtol または std::strtoll) が errno を ERANGE に設定した場合、 std::out_of_range。

例

Run this code

#include <iostream>#include <string>   int main(){std::string str1 ="45";std::string str2 ="3.14159";std::string str3 ="31337 with words";std::string str4 ="words and 2";   int myint1 = std::stoi(str1);int myint2 = std::stoi(str2);int myint3 = std::stoi(str3);// error: 'std::invalid_argument'// int myint4 = std::stoi(str4);   std::cout<<"std::stoi(\""<< str1 <<"\") is "<< myint1 <<'\n';std::cout<<"std::stoi(\""<< str2 <<"\") is "<< myint2 <<'\n';std::cout<<"std::stoi(\""<< str3 <<"\") is "<< myint3 <<'\n';//std::cout << "std::stoi(\"" << str4 << "\") is " << myint4 << '\n';}

出力:

std::stoi("45") is 45 std::stoi("3.14159") is 3 std::stoi("31337 with words") is 31337

関連項目

stoulstoull (C++11)(C++11)	文字列を符号なし整数に変換します (関数)
stofstodstold (C++11)(C++11)(C++11)	文字列を浮動小数点値に変換します (関数)
strtolstrtoll (C++11)	バイト文字列を整数値に変換します (関数)
strtoulstrtoull (C++11)	バイト文字列を符号なし整数値に変換します (関数)
strtoimaxstrtoumax (C++11)(C++11)	バイト文字列を std::intmax_t または std::uintmax_t に変換します (関数)
from_chars (C++17)	文字シーケンスを整数値または浮動小数点値に変換します (関数)
atoiatolatoll (C++11)	バイト文字列を整数値に変換します (関数)
to_string (C++11)	整数または浮動小数点値を string に変換します (関数)
to_wstring (C++11)	整数または浮動小数点値を wstring に変換します (関数)