_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Converter uma seqüência de caracteres em um __int64 valor.

__int64 _strtoi64(
   const char *nptr,
   char **endptr,
   int base 
);
__int64 _wcstoi64(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
__int64 _strtoi64_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
__int64 _wcstoi64_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
    A localidade para usar.

Valor de retorno

_strtoi64 Retorna o valor representado na seqüência de caracteres nptr, exceto quando a representação poderia causar um estouro de capacidade, que nesse caso retorna _I64_MAX ou _I64_MIN. A função retornará 0 se nenhuma conversão pode ser executada._wcstoi64 Retorna valores analogously para strtoi64.

_I64_MAX e _I64_MIN são definidos em LIMITS.H.

If nptr é NULL ou o base é diferente de zero e o menor 2 ou maior do que 36, errno é definido como EINVAL.

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

Comentários

The _strtoi64function converts nptr to an __int64.sistema autônomo duas funções parar de ler a seqüência de caracteres nptr no primeiro caractere 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. _wcstoi64 é uma versão de caractere largo da _strtoi64; sua nptr argumento é uma seqüência de caracteres largos. Essas funções se comportam exatamente caso contrário.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H

_UNICODE & _MBCS não definido

_MBCS definido

_UNICODE definido

_tcstoi64

_strtoi64

_strtoi64

_wcstoi64

_tcstoi64_l

_strtoi64_l

_strtoi64_l

_wcstoi64_l

LC_NUMERIC categoria determina o reconhecimento do caractere fracionário nptr*;* para obter mais informações, consulte setlocale.The functions without the _l suffix use the current locale; _strtoi64_l and_wcstoi64_l are identical to the corresponding function without the _l suffix except that they use the locale passed in instead.Para obter mais informações, consulte 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.

_strtoi64 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.

Requisitos

Rotina

Cabeçalho necessário

_strtoi64, _strtoi64_l

<stdlib.h>

_wcstoi64, _wcstoi64_l

<stdlib.h> ou <wchar.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Consulte também

Referência

Conversão de Dados

Localidade

localeconv

setlocale, _wsetlocale

Seqüência de caracteres para funções de valor numérico

strtod, _strtod_l, wcstod, _wcstod_l

strtoul, _strtoul_l, wcstoul, _wcstoul_l

atof, _atof_l, _wtof, _wtof_l