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ę:
[] [
whitespace
sign
] [] [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 rutyna |
_UNICODE i _MBCS niezdefiniowane |
_MBCS zdefiniowany |
_UNICODE zdefiniowany |
---|---|---|---|
_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