_strtoi64、_wcstoi64、_strtoi64_l、_wcstoi64_l

發行項
06/09/2015

將字串轉換成 __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 回傳值的方式與 strtoi64 相似。

_I64_MAX 和 _I64_MIN 是在 LIMITS.H 中定義的。

如果 nptr 為 NULL，或 base 為非零值且小於 2 或大於 36，則 errno 會設定為 EINVAL。

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

備註

_strtoi64 函式會將 nptr 轉換成 __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]

whitespace 可包括會被忽略的空格和定位字元； digits 是一個或多個十進位數字。第一個不符合這個格式的字元會停止掃描。如果 base 介於 2 和 36 之間，則會使用它當做數字的底數。如果 base 為 0，則會使用 nptr 指向之字串的初始字元來判斷基底。如果第一個字元是 0，而第二個字元不是「x」或「X」，字串會解譯為八進位整數。如果第一個字元是 '0'，而第二個字元不是「x」或「X」，字串會解譯為十六進位整數。如果第一個字元是 1' 到 '9'，字串會解譯為十進位整數。字母 'a' 到 'z' (或 'A' 到 'Z") 被指派值 10 到 35；只允許指派值小於 base 的字母。在基底範圍外的第一個字元停止掃描。例如，如果 base 為 0，而且掃描的第一個字元是「0」，則假設為八進位整數，且「8」或「9」字元將會停止掃描。