atol, , _atol_l, , _wtol_wtol_l

Przekonwertuj ciąg na długą liczbę całkowitą.

Składnia

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

Parametry

str
Ciąg do przekonwertowania.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

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

Jeśli te funkcje przepełniają się dużymi dodatnimi wartościami całkowitymi, zwracają wartość LONG_MAX. Jeśli funkcje przepełnią się dużymi ujemnymi wartościami całkowitymi, LONG_MIN zwracana jest wartość . 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ą ciąg znaków na wartość długiej liczby całkowitej (atol).

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) kończącym ciąg.

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

[] [whitespacesign] [] [digits]

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

_wtol jest identyczna z atol tą różnicą, że przyjmuje on ciąg znaków szeroki.

Wersje tych funkcji z sufiksem _l są identyczne, 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

TCHAR.H Rutynowych	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tstol	atol	atol	_wtol
_ttol	atol	atol	_wtol

Wymagania

Procedur	Wymagany nagłówek
atol	<stdlib.h>
_atol_l, , _wtol_wtol_l	<stdlib.h> i <wchar.h>

Przykład

W tym programie pokazano, jak liczby przechowywane jako ciągi można przekonwertować na wartości liczbowe przy użyciu atol funkcji .

// 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");
    }
}

Function: atol( "  -2309 " ) = -2309
Function: atol( "314127.64" ) = 314127
Function: atol( "3336402735171707160320" ) = 2147483647
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