Atol, _atol_l, _wtol, _wtol_l

Artigo
02/25/2013

Converta uma seqüência de caracteres para um inteiro longo.

long atol(
   const char *str 
);
long _atol_l(
   const char *str,
   _locale_t locale
);
long _wtol(
   const wchar_t *str 
);
long _wtol_l(
   const wchar_t *str,
   _locale_t locale
);

Parâmetros

str
Seqüência de caracteres a ser convertido.
locale
Código de idioma.

Valor de retorno

Cada função retorna o long valor produzido ao interpretar os caracteres de entrada como um número.O valor de retorno é 0 L para atol se a entrada não pode ser convertida para um valor desse tipo.

No caso de estouro com grandes valores positivos integrais, atol retorna LONG_MAX; no caso de estouro com grandes valores negativos de integrais, LONG_MIN é retornado.Em todos os casos de fora do intervalo, errno for definido como ERANGE.Se o parâmetro passado é NULL, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essas funções definir errno para EINVAL e retornar a 0.

Comentários

Essas funções convertem uma seqüência de caracteres para um valor long integer (atol).

A seqüência de caracteres de entrada é uma seqüência de caracteres que podem ser interpretados como um valor numérico do tipo especificado.A função interrompe a leitura a seqüência de caracteres de entrada no primeiro caractere que ele não reconhece como parte de um número.Esse caractere pode ser a NULL caractere ('\0' ou '\0' de L) a seqüência de terminação.

O str argumento para atol 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.

_wtolé idêntico ao atol exceto que assume uma seqüência de caracteres de largura.

As versões dessas funções com o _l sufixo são idênticas exceto que eles usam o parâmetro de localidade passado em vez da localidade atual.Para obter mais informações, consulte Localidade.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_tstol	atol	atol	_wtol
_ttol	atol	atol	_wtol

Requisitos

Rotinas	Cabeçalho necessário
atol	<stdlib.h>
_atol_l, _wtol, _wtol_l	<stdlib.h> e <wchar.h>

Exemplo

Este programa mostra como os números armazenados como cadeias de caracteres podem ser convertidos em valores numéricos usando o atol função.

// crt_atol.c
// This program shows how numbers stored as
// strings can be converted to numeric values
// using the atol functions.
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

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

    // An example of the atol function
    // with leading and trailing white spaces.
    str = "  -2309 ";
    value = atol( str );
    printf( "Function: atol( \"%s\" ) = %d\n", str, value );

    // Another example of the atol function 
    // with an arbitrary decimal point.
    str = "314127.64";
    value = atol( str );
    printf( "Function: atol( \"%s\" ) = %d\n", str, value );

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