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_MAXve 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 stratoll değişkeni aşağıdaki forma sahiptir:

[whitespace] [sign] [digits]

Bir whitespace , yoksayılan boşluk veya sekme karakterlerinden oluşur; sign artı (+) veya eksi (-) olur ve digits bir veya daha fazla basamaktır.

_wtollatoll 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