strtoull, _strtoull_l, wcstoull, _wcstoull_l

Dizeleri bir unsigned long long tamsayı değerine dönüştürür.

Sözdizimi

unsigned long long strtoull(
   const char *strSource,
   char **endptr,
   int base
);
unsigned long long _strtoull_l(
   const char *strSource,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long long wcstoull(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base
);
unsigned long long _wcstoull_l(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

Parametreler

strSource
Dönüştürülecek null ile sonlandırılan dize.

endptr
Taramayı durduran karakterin işaretçisi.

base
Kullanılacak sayı tabanı.

locale
Kullanılacak yerel ayar.

Dönüş değeri

strtoull dönüştürülen değeri (varsa) veya ULLONG_MAX taşma durumunda döndürür. strtoull dönüştürme gerçekleştirilemiyorsa 0 döndürür. wcstoull ile benzer değerler strtoulldöndürür. Her iki işlev için de errno taşma veya yetersizlik oluşursa olarak ayarlanır ERANGE .

İade kodları hakkında daha fazla bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Açıklamalar

Bu işlevlerin her biri giriş dizesini strSource bir unsigned long long tamsayı değerine dönüştürür.

strtoull dizesini strSource bir sayının parçası olarak tanıyamayan ilk karakterde okumayı durdurur. Sonlandırıcı null karakter veya değerinden büyük veya buna eşit baseilk sayısal karakter olabilir. Yerel ayar kategorisinin ayarı LC_NUMERIC , içindeki radix karakterinin strSourcetanınmasını belirler; daha fazla bilgi için bkz setlocale. , _wsetlocale. strtoull ve wcstoull geçerli yerel ayarı kullanın; _strtoull_l _wcstoull_l bunun yerine geçirilen ancak aksi takdirde aynı olan yerel ayarı kullanın. Daha fazla bilgi için bkz . Yerel Ayar.

değilse endptr NULL, taramayı durduran karakterin işaretçisi tarafından endptrişaret edilen konumda depolanır. Dönüştürme gerçekleştirilemiyorsa (geçerli basamak bulunamadıysa veya geçersiz bir taban belirtildiyse), değeri strSource tarafından endptrişaret edilen konumda depolanır.

wcstoull geniş karakterli bir sürümüdür strtoull ve strSource bağımsız değişkeni geniş karakterli bir dizedir. Aksi takdirde, bu işlevler aynı şekilde davranır.

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
_tcstoull	strtoull	strtoull	wcstoull
_tcstoull_l	strtoull_l	_strtoull_l	_wcstoull_l

strtoullstrSource aşağıdaki biçimdeki bir dizeye işaret etmesini bekler:

[whitespace] [{+ | -}] [0 [{ x | X }]] []digits | letters

A whitespace , yoksayılan boşluk ve sekme karakterlerinden oluşabilir. digits bir veya daha fazla ondalık basamaktır. letters 'a' ile 'z' (veya 'A' - 'Z' arasında) harflerinden biri veya daha fazlasıdır. Bu forma uymayan ilk karakter taramayı durdurur. 2 ile 36 arasındaysa base , sayının tabanı olarak kullanılır. 0 ise base , temeli belirlemek için tarafından strSource işaret edilen dizenin ilk karakterleri kullanılır. İlk karakter '0' ve ikinci karakter 'x' veya 'X' değilse, dize sekizli tamsayı olarak yorumlanır. İlk karakter '0' ve ikinci karakter 'x' veya 'X' ise, dize onaltılık tamsayı olarak yorumlanır. İlk karakter '1' ile '9' arasındaysa, dize ondalık tamsayı olarak yorumlanır. 'a' ile 'z' (veya 'A' ile 'Z' arasında) harflerine 10 ile 35 arasında değerler atanır; yalnızca atanan değerlerden küçük base olan harflere izin verilir. Tabanın aralığının dışındaki ilk karakter taramayı durdurur. Örneğin, 0 ise ve taranan ilk karakter '0' ise base sekizli bir tamsayı varsayılır ve '8' veya '9' karakteri taramayı durdurur. strtoull artı işaretine (+) veya eksi işaretine (-) izin verir; baştaki eksi işareti, dönüş değerinin negatif olduğunu gösterir.

Gereksinimler

Yordam	Gerekli başlık
strtoull	<stdlib.h>
wcstoull	<stdlib.h> veya <wchar.h>
_strtoull_l	<stdlib.h>
_wcstoull_l	<stdlib.h> veya <wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

örneğine strtodbakın.

Ayrıca bkz.

Veri dönüştürme
Yerel ayar
localeconv
setlocale, _wsetlocale
Sayısal değer işlevlerine dize
strtod, _strtod_l, wcstod, _wcstod_l
strtol, wcstol, _strtol_l, _wcstol_l
strtoul, _strtoul_l, wcstoul, _wcstoul_l
strtoll, _strtoll_l, wcstoll, _wcstoll_l
atof, _atof_l, _wtof, _wtof_l