atoll, _atoll_l, _wtoll, _wtoll_l

Converte uma cadeia de caracteres em um inteiro long long.

Sintaxe

long long atoll(
   const char *str
);
long long _wtoll(
   const wchar_t *str
);
long long _atoll_l(
   const char *str,
   _locale_t locale
);
long long _wtoll_l(
   const wchar_t *str,
   _locale_t locale
);

Parâmetros

str
Cadeia de caracteres a ser convertida.

locale
Localidade a usar.

Valor retornado

Cada função retorna o valor long long produzido interpretando os caracteres de entrada como um número. O valor retornado for atoll será 0 se a entrada não puder ser convertida em um valor desse tipo.

Para estouro com grandes valores inteiros positivos, atoll retorna LLONG_MAX; o estouro com grandes valores inteiros negativos retorna LLONG_MIN.

Em todos os casos de fora do intervalo, errno é definido como ERANGE. Se o parâmetro passado for NULL, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, essas funções definirão errno como EINVAL e retornarão 0.

Comentários

Essas funções convertem uma cadeia de caracteres em um valor inteiro long long.

A cadeia de caracteres de entrada é uma sequência de caracteres que pode ser interpretada como um valor numérico do tipo especificado. A função para de ler a cadeia de caracteres de entrada no primeiro caractere que não pode ser reconhecida como parte de um número. Esse caractere pode ser o caractere nulo ('\0' ou '\0' L) que encerra a cadeia de caracteres.

O argumento str para atoll tem a seguinte forma:

[whitespace] [sign] [digits]

Um whitespace consiste em caracteres de espaço ou tabulação, que são ignorados; sign é um sinal de mais (+) ou menos (-); e digits é um ou mais dígitos.

_wtoll é idêntico a atoll, exceto que assume uma cadeia de caracteres largos como um parâmetro.

As versões dessas funções que têm o sufixo _l são idênticas às versões que não têm, exceto por usarem o parâmetro de localidade que é passado no lugar da localidade atual. Para obter mais informações, consulte Localidade.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_tstoll	atoll	atoll	_wtoll
_tstoll_l	_atoll_l	_atoll_l	_wtoll_l
_ttoll	_atoll	_atoll	_wtoll

Requisitos

Rotinas	Cabeçalho necessário
atoll, _atoll_l	<stdlib.h>
_wtoll, _wtoll_l	<stdlib.h> ou <wchar.h>

Exemplo

Este programa mostra como usar as funções atoll para converter números armazenados como cadeias de caracteres em valores numéricos.

// crt_atoll.c
// Build with: cl /W4 /Tc crt_atoll.c
// This program shows how to use the atoll
// functions to convert numbers stored as
// strings to numeric values.
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

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

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

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

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

Function: atoll("  -27182818284 ") = -27182818284
Function: atoll("314127.64") = 314127
Function: atoll("3336402735171707160320") = 9223372036854775807
Overflow condition occurred.

Confira também

Conversão de dados
Suporte matemático e de ponto flutuante
Localidade
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, , _atoflt_l