atol
, _atol_l
, _wtol
, _wtol_l
Bir dizeyi uzun bir tamsayıya dönüştürün.
Sözdizimi
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
);
Parametreler
str
Dönüştürülecek dize.
locale
Kullanılacak yerel ayar.
Dönüş değeri
Her işlev, giriş karakterlerini sayı olarak yorumlayarak üretilen değeri döndürür long
. Dönüş değeri, 0L
atol
girişin bu türdeki bir değere dönüştürülemediğini gösterir.
Bu işlevler büyük pozitif integral değerleriyle taşıyorsa, döndürür LONG_MAX
. İşlevler büyük negatif integral değerleriyle taşıyorsa, LONG_MIN
döndürülür. Tüm aralık dışı durumlarda olarak errno
ayarlanır ERANGE
. geçirilen parametre iseNULL
, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler olarak EINVAL
ayarlanır errno
ve 0 döndürür.
Açıklamalar
Bu işlevler bir karakter dizesini uzun bir tamsayı değerine (atol
) dönüştürür.
Giriş dizesi, belirtilen türün sayısal değeri olarak yorumlanabilir bir karakter dizisidir. İşlev, giriş dizesini bir sayının parçası olarak tanıyamayan ilk karakterde okumayı durdurur. Bu karakter, dizeyi sonlandıran null karakter (\0
veya L\0
) olabilir.
bağımsız str
atol
değişkeni aşağıdaki forma sahiptir:
[
whitespace
] [] [digits
sign
]
A whitespace
, yoksayılan boşluk veya sekme karakterlerinden oluşur; sign
artı (+
) veya eksi (-
) olur ve digits
bir veya daha fazla basamaktır.
_wtol
ile aynıdır atol
, ancak geniş bir karakter dizesi alır.
Bu işlevlerin sonekli _l
sürümleri aynıdır, ancak geçerli yerel ayar yerine geçirilen yerel ayar parametresini kullanırlar. Daha fazla bilgi için bkz . Yerel Ayar.
Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.
Genel metin yordamı eşlemeleri
TCHAR.H olağan |
_UNICODE ve _MBCS tanımlanmadı |
_MBCS tanımlanan |
_UNICODE tanımlanan |
---|---|---|---|
_tstol |
atol |
atol |
_wtol |
_ttol |
atol |
atol |
_wtol |
Gereksinimler
Rutin | Gerekli başlık |
---|---|
atol |
<stdlib.h> |
_atol_l , _wtol , _wtol_l |
<stdlib.h> ve <wchar.h> |
Örnek
Bu program, dize olarak depolanan sayıların atol
işlevi kullanılarak sayısal değerlere nasıl dönüştürülebileceğini gösterir.
// 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.
Ayrıca bkz.
Veri dönüştürme
Matematik ve kayan nokta desteği
Yerel ayar
_ecvt
_fcvt
_gcvt
setlocale
, _wsetlocale
_atodbl
, _atodbl_l
, _atoldbl
, , _atoldbl_l
, _atoflt
, _atoflt_l