std::strtol, std::strtoll - cppreference.com

De cppreference.com

Definido no cabeçalho `<cstdlib>`

`long strtol( const char str, char *str_end, int base );`

`long long strtoll( const char str, char *str_end, int base );`		(desde C++11)

Interpreta um valor inteiro em uma seqüência de bytes apontado por str.

Original:

Interprets an integer value in a byte string pointed to by str.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Function discards any whitespace characters until first non-whitespace character is found. Then it takes as many characters as possible to form a valid base-n (where n=base) integer number representation and converts them to an integer value. The valid integer value consists of the following parts:

(opcional) plus or minus sign
(opcional) prefix (0) indicating octal base (applies only when the base is 8)
(opcional) prefix (0x or 0X) indicating hexadecimal base (applies only when the base is 16)
a sequence of digits

The set of valid digits for base-2 integer is 01, for base-3 integer is 012, and so on. For bases larger than 10, valid digits include alphabetic characters, starting from Aa for base-11 integer, to Zz for base-36 integer. The case of the characters is ignored.

As funções define o ponteiro apontado pelo str_end para apontar para o caráter passado o último personagem interpretado. Se str_end é NULL, ele é ignorado.

Original:

The functions sets the pointer pointed to by str_end to point to the character past the last character interpreted. If str_end is NULL, it is ignored.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Se o str está vazia ou não tem a forma esperada, nenhuma conversão é realizada, e (se não é str_end NULL) o valor de str é armazenado no objeto apontado por str_end.

Original:

If the str is empty or does not have the expected form, no conversion is performed, and (if str_end is not NULL) the value of str is stored in the object pointed to by str_end.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Parâmetros

str	-	ponteiro para o byte string terminada em nulo para ser interpretado Original: pointer to the null-terminated byte string to be interpreted The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
str_end	-	ponteiro para um ponteiro para caracter . Original: pointer to a pointer to character. The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
base	-	Base do valor inteiro interpretado Original: base of the interpreted integer value The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

Valor de retorno

Se for bem sucedido, um valor inteiro correspondente ao conteúdo do str é retornado.
Original:
If successful, an integer value corresponding to the contents of str is returned.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
Se o valor convertido cai fora do alcance do tipo de retorno correspondente, ocorre um erro de gama (configuração errno para ERANGE) e LONG_MAX, LONG_MIN, LLONG_MAX ou LLONG_MIN é devolvido.
Original:
If the converted value falls out of range of corresponding return type, a range error occurs (setting errno to ERANGE) and LONG_MAX, LONG_MIN, LLONG_MAX or LLONG_MIN is returned.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
Se nenhuma conversão pode ser executada, é devolvido 0.
Original:
If no conversion can be performed, 0 is returned.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Exemplo

Veja também


atoi atol atoll	converte uma seqüência de byte para um valor inteiro Original: converts a byte string to an integer value The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função) [edit]

strtoul strtoull	converte uma seqüência de byte para um valor inteiro sem sinal Original: converts a byte string to an unsigned integer value The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função) [edit]

Documentação C para strtol, strtoll

Categorias: