stoi
Konvertiert eine Zeichenfolge in eine Ganzzahl.
int stoi( const string& _Str, size_t *_Idx = 0, int _Base = 10 ); int stoi( const wstring& _Str, size_t *_Idx = 0, int _Base = 10 );
Rückgabewert
Der Ganzzahlwert.
Parameter
Parameter |
Beschreibung |
|---|---|
_Str |
Die zu konvertierende Zeichenfolge. |
_Idx |
Enthält den Index des ersten Zeichens ohne Konvertierung bei der Rückgabe. |
_Base |
Die zu verwendende Zahlenbasis. |
Hinweise
Die Funktion stoi konvertiert die Zeichenfolge in _Str in einen Wert des Typs int und gibt den Wert zurück. Wenn beispielsweise die Zeichenfolge "10" übergeben wurde, ist der durch stoi zurückgegebene Wert die Ganzzahl 10.
stoi ähnelt der Funktion strtol bei Einzelbyte-Zeichen, wenn der Aufruf über strtol(_Str.c_str(), _Eptr, _Base) erfolgt, wobei _Eptr ein internes Objekt der Funktion ist, oder wcstol bei Breitzeichen, wenn der Aufruf ähnlich über wcstol(Str.c_str(), _Eptr, _Base) erfolgt. Weitere Informationen finden Sie unter strtol, wcstol, _strtol_l, _wcstol_l.
Bei _Str.c_str() == *_Eptr, stoi wird ein Objekt vom Typ invalid_argument ausgegeben. Wenn bei solch einem Aufruf errno festgelegt wird oder der zurückgegebene Wertnicht als ein Objekt vom Typ int dargestellt werden kann, wird ein Objekt vom Typ out_of_range ausgegeben. Andernfalls gilt: Wenn _Idx kein NULL-Zeiger ist, speichert die Funktion *_Eptr - __Str.c_str() in *_Idx.
Anforderungen
Header: <string>
Namespace: std