atoi, _atoi_l, _wtoi, _wtoi_l

Artigo
08/25/2010

Converter uma seqüência de caracteres em inteiro.

int atoi(
   const char *str 
);
int _wtoi(
   const wchar_t *str 
);
int _atoi_l(
   const char *str,
   _locale_t locale
);
int _wtoi_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 int valor produzido por interpretar sistema autônomo caracteres de entrada sistema autônomo um número. O valor retornado é 0 para atoi e _wtoi, se a entrada não pode ser convertida para um valor de tipo.

In Visual C++ 2005, no caso de estouro com grandes valores negativos integrais, LONG_MIN será retornado. atoi e _wtoi retornar INT_MAX e INT_MIN nestas condições. 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 como um valor inteiro (atoi e _wtoi). 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 atoie _wtoi 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.

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 & _MBCS não definido	_MBCS definido	_UNICODE definido
_tstoi	atoi	atoi	_wtoi
_ttoi	atoi	atoi	_wtoi

Requisitos

Rotinas de	Cabeçalho necessário
atoi	<stdlib.h>
_atoi_l, _wtoi, _wtoi_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 atoi funções.

// crt_atoi.c
// This program shows how numbers 
// stored as strings can be converted to
// numeric values using the atoi functions.

#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

int main( void )
{
    char    *str = NULL;
    int     value = 0;

    // An example of the atoi function.
    str = "  -2309 ";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function.
    str = "31412764";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function 
    // with an overflow condition occuring.
    str = "3336402735171707160320";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );
    if (errno == ERANGE)
    {
       printf("Overflow condition occurred.\n");
    }
}

Function: atoi( "  -2309 " ) = -2309 Function: atoi( "31412764" ) = 31412764 Function: atoi( "3336402735171707160320" ) = 2147483647 Overflow condition occurred.