Compartir a través de


stoi

Convierte una secuencia de caracteres a un entero.

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

Valor devuelto

Valor entero.

Parámetros

Parámetro

Descripción

_Str

La secuencia de caracteres que se va a convertir.

_Idx

Contiene el índice del primer carácter no en volver.

_Base

Base de número a utilizar.

Comentarios

La función stoi convierte la secuencia de caracteres de _Str a un valor de int escrito y devuelve el valor.Por ejemplo, cuando se pasa una secuencia “10 " de caracteres, el valor devuelto por stoi es los 10. enteros.

stoi se comporta de forma similar a la función strtol por caracteres de un solo byte cuando se llama a de la manera strtol(_Str.c_str(), _Eptr, _Base), donde es un objeto _Eptr interno a la función; o wcstol por caracteres anchos, cuando se llama de forma similar, wcstol(Str.c_str(), _Eptr, _Base).Para obtener más información, vea strtol, wcstol, _strtol_l, _wcstol_l.

Si _Str.c_str() == *_Eptr,stoi produce un objeto de invalid_argumentescrito.Si esta llamada establece errno, o si el valor devueltono se puede representar como un objeto de inttipo, se produce un objeto de out_of_rangeescrito.Si no, si _Idx no es un puntero NULL, la función almacena *_Eptr - __Str.c_str() en *_Idx.

Requisitos

encabezado: <cadena>

espacio de nombres: std

Vea también

Referencia

string (<string>)

wstring

<string>