stoi

整数に文字列に変換します。

int stoi(
    const string& _Str, 
    size_t *_Idx = 0,
    int _Base = 10
);
int stoi(
    const wstring& _Str, 
    size_t *_Idx = 0,
    int _Base = 10
);

戻り値

整数値。

パラメーター

パラメーター	説明
_Str	変換される文字のシーケンス。
_Idx	リターンの最初の変換されていない文字のインデックスが含まれています。
_Base	使用する番号です。

解説

関数 stoi は int 型の値に _Str の文字列に変換し、値を返します。たとえば、渡された場合、文字のシーケンス 「10 "、stoi によって返される整数値 10. です。

stoi は _Eptr が内部関数にオブジェクトの方法 strtol(_Str.c_str(), _Eptr, _Base)で呼び出されるとバイト文字の関数と同様に動作します。strtol、; または同様の方法で呼び出されるとワイド文字の wcstol、wcstol(Str.c_str(), _Eptr, _Base)。詳細については、「strtol、wcstol、_strtol_l、_wcstol_l」を参照してください。

_Str.c_str() == *_Eptr,stoi が invalid_argument型のオブジェクトをスローします。もしこのような呼び出しが errno をセットするか、戻り値がint型のオブジェクトを表せない場合、out_of_range型のオブジェクトをスローします。それ以外 _Idx が null ポインターの場合、この関数は *_Idxで *_Eptr - __Str.c_str() を格納します。

必要条件

ヘッダー: <string>

名前空間: std

参照

関連項目

string (<string>)

wstring

<string>