_atoi64, _atoi64_l, _wtoi64, _wtoi64_l
Converte uma seqüência de caracteres em um número inteiro de 64 bit.
__int64 _atoi64(
const char *str
);
__int64 _wtoi64(
const wchar_t *str
);
__int64 _atoi64_l(
const char *str,
_locale_t locale
);
__int64 _wtoi64_l(
const wchar_t *str,
_locale_t locale
);
Parâmetros
str
Seqüência de caracteres a ser convertido.locale
Localidade usar.
Valor de retorno
Cada função retorna o __int64 valor produzido por interpretar sistema autônomo caracteres de entrada sistema autônomo um número. O valor retornado é 0 para _atoi64 Se a entrada não pode ser convertida para um valor de tipo.
In Visual C++ 2005, no caso de estouro com grandes valores positivos integrais, _atoi64 Retorna I64_MAX e I64_MIN no caso de estouro com grandes valores negativos de inteiro.
Em todos os casos de fora do intervalo, errno é definido como ERANGE. Se o parâmetro passado é NULL, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções conjunto errno para EINVAL e retornar 0.
Comentários
Essas funções convertem uma seqüência de caractere para um valor inteiro de 64 bit.
A cadeia de caracteres de entrada é uma sequência de caracteres que podem ser interpretados sistema autônomo um valor numérico do tipo especificado.A função interrompe a leitura a cadeia de caracteres de entrada no primeiro caractere que não reconhece sistema autônomo parte de um número.Esse caractere pode ser o caractere nulo ('\0' ou '\0' L) encerrar a cadeia de caracteres.
The str argumento para _atoi64 tem a seguinte forma:
[whitespace] [sign] [digits]]
A whitespace consiste em caracteres de espaço ou tabulação, que são ignorados sign é um sinal de adição (+) ou menos (-); e digits são um ou mais dígitos.
_wtoi64 é idêntico ao _atoi64 exceto que assume uma seqüência de caractere longa sistema autônomo um parâmetro.
As versões dessas funções com o _l sufixo são idênticas exceto que usarem o parâmetro de localidade passado em vez da localidade corrente. For more information, see Localidade.
Mapeamentos de rotina de texto genérica
Rotina tchar.h |
_UNICODE e _MBCS não definido |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_tstoi64 |
_atoi64 |
_atoi64 |
_wtoi64 |
_ttoi64 |
_atoi64 |
_atoi64 |
_wtoi64 |
Requisitos
Rotinas de |
Cabeçalho necessário |
---|---|
_atoi64, _atoi64_l |
<stdlib.h> |
_wtoi64, _wtoi64_l |
<stdlib.h> ou <wchar.h> |
Exemplo
Este programa mostra sistema autônomo sistema autônomo números armazenados sistema autônomo seqüências de caracteres podem ser convertidas em valores numéricos usando o _atoi64 funções.
// crt_atoi64.c
// This program shows how numbers stored as
// strings can be converted to numeric values
// using the _atoi64 functions.
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>
int main( void )
{
char *str = NULL;
__int64 value = 0;
// An example of the _atoi64 function
// with leading and trailing white spaces.
str = " -2309 ";
value = _atoi64( str );
printf( "Function: _atoi64( \"%s\" ) = %d\n", str, value );
// Another example of the _atoi64 function
// with an arbitrary decimal point.
str = "314127.64";
value = _atoi64( str );
printf( "Function: _atoi64( \"%s\" ) = %d\n", str, value );
// Another example of the _atoi64 function
// with an overflow condition occurring.
str = "3336402735171707160320";
value = _atoi64( str );
printf( "Function: _atoi64( \"%s\" ) = %d\n", str, value );
if (errno == ERANGE)
{
printf("Overflow condition occurred.\n");
}
}
Function: _atoi64( " -2309 " ) = -2309 Function: _atoi64( "314127.64" ) = 314127 Function: _atoi64( "3336402735171707160320" ) = -1 Overflow condition occurred.