stoi
Convertit une séquence de caractères en entier.
int stoi( const string& _Str, size_t *_Idx = 0, int _Base = 10 ); int stoi( const wstring& _Str, size_t *_Idx = 0, int _Base = 10 );
Valeur de retour
Valeur entière.
Paramètres
Paramètre |
Description |
|---|---|
_Str |
Séquence de caractères à convertir. |
_Idx |
Contient l'index du premier caractère non converti au retour. |
_Base |
Base numérique à utiliser. |
Notes
La fonction stoi convertit la séquence de caractères de _Str en une valeur de type int, puis retourne la valeur. Par exemple, quand la séquence de caractères « 10 » est passée, la valeur retournée par stoi est l'entier 10.
stoi a un comportement semblable à celui de la fonction strtol pour les caractères codés sur un octet quand la fonction est appelée sous la forme strtol(_Str.c_str(), _Eptr, _Base), où _Eptr est un objet interne à la fonction. Sinon, son comportement est semblable à celui de la fonction wcstol pour les caractères larges, quand elle est appelée de manière similaire, wcstol(Str.c_str(), _Eptr, _Base). Pour plus d'informations, consultez strtol, wcstol, _strtol_l, _wcstol_l.
Si _Str.c_str() == *_Eptr, stoi lève un objet de type invalid_argument. Si ce genre d'appel définit errno, ou si la valeur retournée ne peut pas être représentée sous la forme d'un objet de type int, un objet de type out_of_range est levé. Sinon, si _Idx n'est pas un pointeur null, la fonction stocke *_Eptr - __Str.c_str() dans *_Idx.
Configuration requise
En-tête : <string>
Espace de noms : std