stoi
Converte uma sequência de caracteres em um número inteiro.
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 de retorno
O valor inteiro.
Parâmetros
Parâmetro |
Descrição |
|---|---|
_Str |
A sequência de caracteres a ser convertida. |
_Idx |
Contém o índice do primeiro caractere não convertido em retorno. |
_Base |
O número base a usar. |
Comentários
A função stoi converte a sequência de caracteres em _Str em um valor do tipo int e retorna o valor. Por exemplo, quando foi passada uma sequência de caracteres "10", o valor retornado por stoi é o inteiro 10.
stoi comporta-se de forma semelhante à função strtol para caracteres de byte único quando é chamado na forma strtol(_Str.c_str(), _Eptr, _Base), em que _Eptr é um objeto interno à função; ou wcstol para caracteres largos, quando é chamado de maneira semelhante, wcstol(Str.c_str(), _Eptr, _Base). Para obter mais informações, consulte strtol, wcstol, _strtol_l, _wcstol_l.
Se _Str.c_str() == *_Eptr, stoi gerar um objeto do tipo invalid_argument. Se essa chamada definiria errno, ou se o valor retornadonão pode ser representado como um objeto do tipo int, ele gera um objeto do tipo out_of_range. Caso contrário, se _Idx não for um ponteiro nulo, a função armazenará *_Eptr - __Str.c_str() na *_Idx.
Requisitos
Cabeçalho: < string >
Namespace: std