atoll
, _atoll_l
, _wtoll
, _wtoll_l
Dizeyi tamsayıya long long
dönüştürür.
Sözdizimi
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
);
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 oluşturulan değeri döndürür long long
. Giriş bu türdeki bir değere atoll
dönüştürülemiyorsa için dönüş değeri 0'dır.
Büyük pozitif tamsayı değerlerine sahip taşma için, atoll
döndürür LLONG_MAX
ve büyük negatif tamsayı değerlerine sahip taşma için döndürür LLONG_MIN
.
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 tamsayı long long
değerine 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
atoll
değişkeni aşağıdaki forma sahiptir:
[
whitespace
] [] [digits
sign
]
Bir whitespace
, yoksayılan boşluk veya sekme karakterlerinden oluşur; sign
artı (+) veya eksi (-) olur ve digits
bir veya daha fazla basamaktır.
_wtoll
atoll
parametresi olarak geniş bir karakter dizesi alması dışında aynıdır.
Bu işlevlerin son ekine _l
sahip sürümleri, geçerli yerel ayar yerine geçirilen yerel ayar parametresini kullanmaları dışında, bu işlevlere sahip olmayan sürümler ile aynıdır. 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 yordamı | _UNICODE ve _MBCS tanımlanmadı |
_MBCS tanımlanan |
_UNICODE tanımlanan |
---|---|---|---|
_tstoll |
atoll |
atoll |
_wtoll |
_tstoll_l |
_atoll_l |
_atoll_l |
_wtoll_l |
_ttoll |
_atoll |
_atoll |
_wtoll |
Gereksinimler
Rutin | Gerekli başlık |
---|---|
atoll , _atoll_l |
<stdlib.h> |
_wtoll , _wtoll_l |
<stdlib.h> veya <wchar.h> |
Örnek
Bu program, dize olarak depolanan sayıları sayısal değerlere dönüştürmek için işlevlerin nasıl kullanılacağını atoll
gösterir.
// 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.
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