Compartilhar via


stoi

Converte uma seqüê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 seqüência de caracteres a ser convertido.

_Idx

Contém o índice do primeiro caractere em unconverted retorno.

_Base

A base de número a ser usada.

Comentários

A função stoi converte a seqüência de caracteres em _Str um valor do tipo int e retorna o valor.Por exemplo, quando passada uma seqüência de caracteres “10 ", o valor retornado por stoi é 10. o inteiro.

stoi se comporta de forma semelhante à função para strtol caracteres de byte único quando é chamada da forma strtol(_Str.c_str(), _Eptr, _Base), onde _Eptr é um objeto interno para a função; ou wcstol para caracteres largos, quando é chamado da forma semelhante, wcstol(Str.c_str(), _Eptr, _Base).Para mais informações, consulte strtol, wcstol, _strtol_l, _wcstol_l.

Se _Str.c_str() == *_Eptr,stoi gera um objeto do tipo invalid_argument.Se tal 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 é um ponteiro zero, a função *_Eptr - __Str.c_str() armazena em *_Idx.

Requisitos

Cabeçalho: <string>

namespace: STD

Consulte também

Referência

string (<string>)

wstring

<string>