_strtoi64
, _wcstoi64
, _strtoi64_l
, _wcstoi64_l
Dizeyi bir __int64
değere dönüştürün.
Sözdizimi
__int64 _strtoi64(
const char *strSource,
char **endptr,
int base
);
__int64 _wcstoi64(
const wchar_t *strSource,
wchar_t **endptr,
int base
);
__int64 _strtoi64_l(
const char *strSource,
char **endptr,
int base,
_locale_t locale
);
__int64 _wcstoi64_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 karakter işaretçisi.
base
Kullanılacak sayı tabanı.
locale
Kullanılacak yerel ayar.
Dönüş değeri
_strtoi64
, dizesinde strSource
temsil edilen değeri döndürür, ancak gösterimin taşmasına neden olacağı durumlar dışında veya döndürür _I64_MAX
_I64_MIN
. Dönüştürme gerçekleştirilemezse işlev 0 döndürür. _wcstoi64
ile benzer değerler _strtoi64
döndürür.
_I64_MAX
ve _I64_MIN
LIMITS.H.'de tanımlanır.
ise strSource
NULL
veya base
sıfır değilse ve 2'den küçük veya 36'dan büyükse olarak errno
ayarlanır EINVAL
.
İade kodları hakkında daha fazla bilgi için bkz. errno
, _doserrno
, _sys_errlist
ve _sys_nerr
.
Açıklamalar
_strtoi64
işlevi bir __int64
öğesine dönüştürülürstrSource
. Her iki işlev de dizeyi strSource
bir sayının parçası olarak tanıyamadıkları ilk karakterde okumayı durdurur. Sonlandırıcı null karakter olabilir veya değerinden büyük veya buna eşit base
ilk sayısal karakter olabilir. _wcstoi64
geniş karakterli _strtoi64
bir sürümüdür; strSource
bağımsız değişkeni geniş karakterli bir dizedir. Bu işlevler aynı şekilde davranır.
Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bunu 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 |
---|---|---|---|
_tcstoi64 |
_strtoi64 |
_strtoi64 |
_wcstoi64 |
_tcstoi64_l |
_strtoi64_l |
_strtoi64_l |
_wcstoi64_l |
Yerel ayarın LC_NUMERIC
kategori ayarı içindeki radix karakterinin strSource
tanınmasını belirler; daha fazla bilgi için bkz setlocale
. . Soneki olmayan _l
işlevler geçerli yerel ayarı _strtoi64_l
kullanır ve _wcstoi64_l
bunun yerine geçirilen yerel ayarı kullanmaları dışında, sonek olmadan _l
karşılık gelen işlevle aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.
değilse endptr
NULL
, taramayı durduran karakterin işaretçisi tarafından endptr
iş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 endptr
işaret edilen konumda depolanır.
_strtoi64
strSource
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.
Gereksinimler
İşlev | Gerekli başlık |
---|---|
_strtoi64 , _strtoi64_l |
<stdlib.h> |
_wcstoi64 , _wcstoi64_l |
<stdlib.h> veya <wchar.h> |
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
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
strtoul
, _strtoul_l
, wcstoul
, _wcstoul_l
atof
, _atof_l
, _wtof
, _wtof_l