_strtoi64、 _wcstoi64、 _strtoi64_l、 _wcstoi64_l

發行項
02/28/2013

將字串轉換為__int64的值。

__int64 _strtoi64(
   const char *nptr,
   char **endptr,
   int base 
);
__int64 _wcstoi64(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
__int64 _strtoi64_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
__int64 _wcstoi64_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

參數

nptr
要轉換的 null 結尾字串。
endptr
停止掃描的字元指標。
base
若要使用的數目已經基底。
locale
若要使用地區設定。

傳回值

_strtoi64傳回值表示字串中的nptr，但當表示會造成溢位，則它傳回_I64_MAX或_I64_MIN。如果可以不執行任何轉換，該函式會傳回 0。 _wcstoi64傳回值為 analogously strtoi64。

_I64_MAX與_I64_MIN所述的限制。H.

如果nptr是NULL或base不是零，並不到 2 或大於 36， errno設為EINVAL。

請參閱 _doserrno、 errno、 _sys_errlist，以及 _sys_nerr 如需有關這些項目，和其他的詳細資訊，任何傳回碼。

備註

The _strtoi64function converts nptr to an __int64. 這兩個函式會停止讀取字串nptr在它們無法辨識的數字的第一個字元。這可能是結束的 null 字元，或可能是第一個數字大於或等於base。 _wcstoi64寬字元版本的_strtoi64。其nptr引數為寬字元字串。這些函式具有相同其他方式作業。

泛用文字常式對應

TCHAR。H 常式	_UNICODE & 未定義的 _MBCS	定義的 _MBCS	定義 _unicode 之後
_tcstoi64	_strtoi64	_strtoi64	_wcstoi64
_tcstoi64_l	_strtoi64_l	_strtoi64_l	_wcstoi64_l

地區設定的LC_NUMERIC類別的設定會決定辨識基數字元的nptr*;*如需詳細資訊，請參閱 setlocale。沒有 _l 的後置字函式使用目前的地區設定; _strtoi64_l與_wcstoi64_l都與對應的函式，而不_l尾碼不同之處在於它們使用地區設定中傳遞。如需詳細資訊，請參閱地區設定。

如果endptr不是NULL，要停止掃描的字元指標儲存在所指位置endptr。如果可以不執行任何轉換 (找不到沒有有效的數字或指定無效的基底) 的值nptr儲存在所指位置endptr。

_strtoi64預期nptr為指向字串的格式如下：

[whitespace] [{+ | –}] [0 [{ x | X }]] [digits]

A whitespace可能會包含空格及 tab 鍵字元，會被忽略； digits有一或多個十進位數字。不適合這種形式的第一個字元就會停止掃描。如果base是介於 2 和 36，那麼它會使用的數字基底。如果base為 0，起始的字元字串所指的nptr用來判斷基底。如果第一個字元是 0，第二個字元不是 'x' X'，字串會解譯為八進位的整數。否則，它即解譯為十進位的數字。如果第一個字元是 '0'，第二個字元是 'x' X'，字串會解譯成十六進位整數。如果第一個字元是 '1' 到' 9'，此字串會解譯為十進位整數。字母 'a' 到 'z' (或 'A' 到 'Z') 被指派的值 10，透過 35。字母其指派的值是小於base允許的。