strtoul, _strtoul_l, wcstoul, _wcstoul_l

Artigo
02/25/2013

Converta seqüências de caracteres em um valor de inteiro longo não assinado.

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
Seqüência terminada por caractere nulo para converter.
endptr
Ponteiro para o caractere que interrompe a varredura.
base
Número base a ser usado.
locale
Código de idioma.

Valor de retorno

strtoulRetorna o valor convertido, se houver, ou ULONG_MAX excedente.strtoulRetorna 0 se nenhuma conversão pode ser executada.wcstoulRetorna valores analogamente para strtoul.Para ambas as funções, errno for definido como ERANGE se ocorrer estouro positivo ou negativo.

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

Comentários

Cada uma dessas funções converte a seqüência de caracteres de entrada nptr para um unsignedlong.

strtoulInterrompe a leitura a seqüência de caracteres nptr no primeiro caractere que não reconhece como parte de um número.Isso pode ser o caractere nulo de terminação, ou pode ser o primeiro caractere numérico maior que ou igual a base.O LC_NUMERIC categoria determina da localidade do reconhecimento do caractere fracionário nptr; Para obter mais informações, consulte setlocale.strtoule wcstoul usar o local atual; _strtoul_le _wcstoul_l são idênticas exceto que eles usam a localidade do passado em vez disso.Para obter mais informações, consulte Localidade.

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

wcstoulé uma versão de caractere largo de strtoul; sua nptr argumento é uma seqüência de caracteres largos.Caso contrário, essas funções tenham comportamento idêntico.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoulespera nptr para apontar para uma seqüência de caracteres do seguinte formato:

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

A whitespace pode consistir em caracteres de espaço e tabulação, que são ignorados; digitssão um ou mais dígitos decimais.O primeiro caractere que não cabe neste formulário pára a varredura.Se base está entre 2 e 36, e em seguida, ele é usado como a base do número.Se base é 0, os caracteres iniciais da seqüência de caracteres apontada por nptr são usados para determinar a base.Se o primeiro caractere é 0 e o segundo caractere não é 'x' ou 'X', a seqüência de caracteres é interpretada como um inteiro octal; Caso contrário, ele é interpretado como um número decimal.Se o primeiro caractere é '0' e o segundo é o caractere 'x' ou 'X', a seqüência de caracteres é interpretada como um inteiro hexadecimal.Se o primeiro caractere é ' 1' a ' 9', a seqüência de caracteres é interpretada como um número inteiro decimal.As letras 'a' a 'z' (ou 'A' a 'Z') é atribuída os valores de 10 a 35; apenas letras cujos valores atribuídos estão menos de base são permitidos.strtoulpermite que um sinal de mais (+) ou sinal de subtração (–) o prefixo de sinal. um sinal de subtração à esquerda indica que o valor de retorno será negado.