std::strtol, std::strtoll

<metanoindex/>

 

C++

Suporte ao Compilador

Freestanding and hosted

Linguagem

Headers da Biblioteca Standard

Requerimentos nomeados

Feature test macros (C++20)

Biblioteca de suporte de língua

Biblioteca de conceitos (C++20)

Biblioteca de diagnósticos

Biblioteca de utilitários em geral

Biblioteca de strings

Biblioteca de containers

Ranges library (C++20)

Biblioteca de iteradores

Biblioteca de algorítmos

Biblioteca numérica

Biblioteca de localizações

Biblioteca de input/output

Biblioteca de sistema de arquivo (C++17)

Biblioteca de expressões regulares (C++11)

Biblioteca de operações atômicas (C++11)

Biblioteca de suporte de thread (C++11)

Especificações Técnicas

Índice de symbolos

Bibliotecas externas

 

Biblioteca cordas

Strings terminadas Original: Null-terminated strings The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

Cadeias de bytes

Multibyte cordas

Cordas de largura

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

basic_string

char_traits

 

Cordas de terminação nula de bytes

Funções Original: Functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
Manipulação personagem Original: Character manipulation The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
Conversões para formatos numéricos Original: Conversions to numeric formats The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
atof atoiatolatoll strtolstrtoll	strtoulstrtoull strtofstrtodstrtold
Manipulação de cadeia Original: String manipulation The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
strcpy
strncpy
strcat
strncat
strxfrm
Exame String Original: String examination The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Manipulação de memória Original: Memory manipulation The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
memchr
memcmp
memset
memcpy
memmove
Diversos Original: Miscellaneous The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
strerror

 

<tbody> </tbody>

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.

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)
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)
Documentação C para strtol, strtoll