atoll, _atoll_l, , _wtoll_wtoll_l

Převede řetězec na long long celé číslo.

Syntaxe

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
);

Parametry

str
Řetězec, který se má převést.

locale
Národní prostředí, které se má použít.

Vrácená hodnota

Každá funkce vrátí long long hodnotu vytvořenou interpretací vstupních znaků jako čísla. Vrácená hodnota je atoll 0, pokud vstup nelze převést na hodnotu tohoto typu.

Pro přetečení s velkými kladnými celočíselnými hodnotami, atoll vrátí a LLONG_MAXpro přetečení s velkými zápornými celočíselnými hodnotami .LLONG_MIN

Ve všech případech errno mimo rozsah je nastavena hodnota ERANGE. Pokud je předaný NULLparametr , vyvolá se neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je možné pokračovat spuštěním, tyto funkce jsou nastavené errno na EINVAL hodnotu 0 a vrátí hodnotu 0.

Poznámky

Tyto funkce převedou řetězec znaků na long long celočíselnou hodnotu.

Vstupní řetězec je posloupnost znaků, kterou lze interpretovat jako číselnou hodnotu zadaného typu. Funkce přestane číst vstupní řetězec na prvním znaku, který nedokáže rozpoznat jako součást čísla. Tento znak může být znak null (\0 nebo L'\0), který řetězec ukončí.

Argument str , který má atoll následující tvar:

[] [whitespace] [digitssign]

Jedná whitespace se o mezeru nebo znaky tabulátoru, které se ignorují; sign jsou buď plus (+) nebo minus (-), a digits jsou jedna nebo více číslic.

_wtoll je shodný s tím rozdílem atoll , že jako parametr přebírá řetězec širokého znaku.

Verze těchto funkcí, které mají příponu _l , jsou identické s verzemi, které ji nemají, s tím rozdílem, že místo aktuálního národního prostředí používají předaný parametr národního prostředí. Další informace naleznete v tématu Národní prostředí.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS definovaný	_UNICODE definovaný
_tstoll	atoll	atoll	_wtoll
_tstoll_l	_atoll_l	_atoll_l	_wtoll_l
_ttoll	_atoll	_atoll	_wtoll

Požadavky

Rutiny	Požadovaný hlavičkový soubor
atoll, _atoll_l	<stdlib.h>
_wtoll, _wtoll_l	<stdlib.h> nebo <wchar.h>

Příklad

Tento program ukazuje, jak pomocí atoll funkcí převést čísla uložená jako řetězce na číselné hodnoty.

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

Viz také

Konverze dat
Podpora pro matematiku a plovoucí desetinou čárku
Národní prostředí
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, , _atoflt_atoflt_l