strtoul, _strtoul_l, wcstoul, _wcstoul_l

Artigo
08/25/2010

Converte seqüências para um valor 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
Localidade usar.

Valor de retorno

strtoul Retorna o valor convertido, se houver, ou ULONG_MAX excedente. strtoul Retorna 0 se nenhuma conversão pode ser executada. wcstoul Retorna valores analogously para strtoul. Para ambas as funções, errno é definido como ERANGE Se ocorrer estouro ou estouro negativo.

See _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre esse e outros, retorne códigos.

Comentários

Each of these functions converts the input string nptr to an unsigned long.

strtoul Interrompe a leitura a seqüência de caracteres nptr no primeiro caractere que não reconhece sistema autônomo 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. The LC_NUMERIC categoria de configuração da localidade determina reconhecimento do caractere fracionário nptr; Para obter mais informações, consulte setlocale.strtoul e wcstoul usar a localidade corrente; _strtoul_l e _wcstoul_l são idênticos, exceto pelo fato de que eles usam a localidade do passado em vez disso. For more information, see Localidade.

If 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 executada (nenhum dígito válido foi encontrado ou uma base inválido foi especificada), o valor de nptr é armazenado na posição apontada por endptr.

wcstoul é uma versão de caractere largo da 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érica

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 para apontar para uma seqüência de caracteres de forma a seguir:

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

A whitespace pode consistir em caracteres de espaço e guia, que são ignorados digits são um ou mais dígitos Decimal. O primeiro caractere que não cabe neste formulário interrompe a varredura.If base está entre 2 e 36, em seguida, é usada sistema autônomo a base do número. If 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 será interpretada sistema autônomo um inteiro octal; caso contrário, ele é interpretado sistema autônomo um número decimal.Se o primeiro caractere é '0' e o segundo caractere será 'x' ou 'X', a seqüência de caracteres é interpretada sistema autônomo um inteiro hexadecimal.Se o primeiro caractere é ' 1 ' através de ' 9 ', a seqüência de caracteres será interpretada sistema autônomo 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 têm menos de base são permitidos. strtoul allows a plus (+) or minus (–) sign prefix; a leading minus sign indicates that the return value is negated.