strtoul, _strtoul_l, wcstoul, _wcstoul_l

Artigo
06/09/2015

Cadeias de caracteres de conversão como um valor inteiro não assinado de manga.

unsigned long strtoul(
   const char *nptr,
   char **endptr,
   int base 
);
unsigned long _strtoul_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long wcstoul(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
unsigned long _wcstoul_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

Parâmetros

nptr
Cadeia de caracteres nula a ser convertida.
endptr
Ponteiro para o caractere que para o exame.
base
Número base a ser usado.
locale
Localidade a ser usada.

Valor de retorno

strtoul retorna o valor convertido, se houver, ou ULONG_MAX em excedentes. strtoul retorna 0 se nenhuma conversão puder ser executada. Valores de retornos do wcstoul análogos a strtoul. Para ambas as funções, errno é definido como ERANGE se o estouro ou o estouro negativo ocorrerem.

Consulte _doserrno, errno, _sys_errlist, e _sys_nerr para obter mais informações sobre esse, e outras, códigos de retorno.

Comentários

Cada uma dessas funções a seguir converte a cadeia de caracteres de entrada nptr a unsignedlong.

strtoul deixa de ler a cadeia de caracteres nptr no primeiro caractere que ela não reconhece ser parte de um número. Pode ser o caractere nulo de terminação,ou o primeiro caractere numérico maior ou igual a base. A configuração da categoria de LC_NUMERIC de localidade determina o reconhecimento de caracteres raiz em nptr; para obter mais informações, consulte setlocale. strtoul e wcstoul usam a localidade atual; _strtoul_l e _wcstoul_l são idênticos exceto que usa a localidade passada por vez. Para obter mais informações, consulte Localidade.

Se endptr não for NULL, um ponteiro para o caractere que interrompeu a verificação é armazenado no local apontado por endptr. Se nenhuma conversão puder ser executada (nenhum dígito válido foi encontrado ou uma base inválida foi especificada), o valor de nptr será armazenado no local apontado por endptr.

wcstoul é uma versão de caractere amplo de strtoul; seu argumento nptr é uma cadeira de caractere longo. Do contrário, essas funções se comportam de forma idêntica.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoul espera nptr apontar para uma cadeia de caracteres de seguinte forma:

[whitespace] [{+ | –}] [0 [{ x | X }]] [digits]

Um whitespace pode conter os caracteres de espaço e de tabulação, que são ignorados; digits são um ou mais dígitos decimais. O primeiro caractere que não se ajusta a este formulário interrompe o exame. Se base estiver entre 2 e 36, então será usado como a base do número. Se base é 0, os caracteres iniciais da cadeia de caracteres apontada por nptr são usados para determinar a base. Se o primeiro caractere for 0 e o segundo não for 'x' ou 'X', a cadeia de caracteres será interpretada como um inteiro octal. Se o primeiro caractere for “0 " e o segundo caractere for “x” ou “X”, a cadeia de caracteres será interpretada como um inteiro hexadecimal. Se o primeiro caractere for “1 " a “9 ", a cadeia de caracteres será interpretada como um número decimal. As letras ”a" a “z” (ou “A” a “Z ") são atribuídas aos valores de 10 a 35; somente letras cujos valores atribuídos são menores que base são permitidas. O primeiro caractere fora do intervalo de base para o exame. Por exemplo, se base for 0 e o primeiro caractere verificado for "0", um número inteiro octal será assumido e um caractere "8" ou "9" interromperá a verificação. strtoul permite a+mais () ou menos o prefixo de sinal (de–); um sinal de menos principal indica que o valor de retorno será negado.