atoll, _atoll_l, _wtoll, _wtoll_l

Konwertuje ciąg na long long liczbę całkowitą.

Składnia

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
Ciąg do przekonwertowania.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Każda funkcja zwraca long long wartość wygenerowaną przez interpretowanie znaków wejściowych jako liczby. Wartość zwracana dla atoll parametru to 0, jeśli nie można przekonwertować danych wejściowych na wartość tego typu.

W przypadku przepełnienia z dużymi dodatnimi wartościami atoll całkowitymi zwraca wartość LLONG_MAXi dla przepełnienia z dużymi ujemnymi wartościami całkowitymi zwraca wartość LLONG_MIN.

We wszystkich przypadkach errno poza zakresem ustawiono wartość ERANGE. Jeśli przekazany parametr to NULL, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonanie może kontynuować, te funkcje są ustawione errno na EINVAL wartość i zwracają wartość 0.

Uwagi

Te funkcje konwertują long long ciąg znaków na wartość całkowitą.

Ciąg wejściowy to sekwencja znaków, które można interpretować jako wartość liczbową określonego typu. Funkcja zatrzymuje odczytywanie ciągu wejściowego przy pierwszym znaku, którego nie może rozpoznać jako części liczby. Ten znak może być znakiem null (\0' lub L'\0),który kończy ciąg.

Argument str do atoll ma następującą formę:

[whitespace] [sign] [digits]

Element whitespace składa się z spacji lub znaków tabulacji, które są ignorowane; sign jest znakiem plus (+) lub minus (-) i digits są co najmniej jedną cyfrą.

_wtoll jest identyczny z atoll tą różnicą, że przyjmuje ciąg znaków szeroki jako parametr.

Wersje tych funkcji, które mają _l sufiks, są identyczne z wersjami, które go nie mają, z tą różnicą, że używają parametru ustawień regionalnych przekazanych zamiast bieżących ustawień regionalnych. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tstoll	atoll	atoll	_wtoll
_tstoll_l	_atoll_l	_atoll_l	_wtoll_l
_ttoll	_atoll	_atoll	_wtoll

Wymagania

Procedur	Wymagany nagłówek
atoll, _atoll_l	<stdlib.h>
_wtoll, _wtoll_l	<stdlib.h> lub <wchar.h>

Przykład

W tym programie pokazano, jak używać atoll funkcji do konwertowania liczb przechowywanych jako ciągów na wartości liczbowe.

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

Zobacz też

Konwersja danych
Obsługa obliczeń matematycznych i zmiennoprzecinkowych
ustawienia regionalne
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l