Partager via


stoi

Convertit une séquence de caractères en un 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

La séquence de caractères à convertir.

_Idx

Contient l'index du premier caractère inconverti au retour.

_Base

La base de numération à utiliser.

Notes

La fonction stoi convertit la séquence de caractères dans _Str à une valeur de type int et retourne la valeur.Par exemple, lorsqu'elle est passée une séquence de caractères « 10 ", la valeur retournée par stoi est 10. les entiers.

stoi se comporte de la même façon à la fonction strtol des caractères codés sur un seul octet lorsqu'elle est appelée de l' strtol(_Str.c_str(), _Eptr, _Base), où _Eptr est un objet interne à la fonction ; ou wcstol des caractères larges, lorsqu'il est appelé de la façon 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 un appel placerait errno, ou si la valeur retournéene peut pas être représentée comme un objet de type int, elle lève un objet de type out_of_range.Sinon, si _Idx n'est pas un pointeur null, la fonction signale *_Eptr - __Str.c_str() dans *_Idx.

Configuration requise

en-tête : <string>

l'espace de noms : DST

Voir aussi

Référence

string (<string>)

wstring

<string>