strtoul、_strtoul_l、wcstoul、_wcstoul_l

發行項
06/09/2015

將字串轉換為 unsigned long 整數值。

unsigned long strtoul(
   const char *nptr,
   char **endptr,
   int base 
);
unsigned long _strtoul_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long wcstoul(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
unsigned long _wcstoul_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

參數

nptr
要轉換的以 Null 結束字串。
endptr
要停止掃描字元的指標。
base
使用的數字底數。
locale
要使用的地區設定。

傳回值

strtoul 傳回轉換後的值 (如果有)，在溢位時則傳回 ULONG_MAX。如果不可以執行轉換動作，strtoul 會傳回 0。 wcstoul 回傳值的方式與 strtoul 相似。對於這兩個函式，如果發生溢位或反向溢位時，errno 會設為 ERANGE。

如需更多關於這些和其他回傳碼的資訊，請參閱 _doserrno 、 errno 、 _sys_errlist 和 _sys_nerr (_doserrno, errno, _sys_errlist, and _sys_nerr) 。

備註

每個這些函式都會將輸入字串 nptr 轉換為 unsignedlong 。

strtoul 在遇到字串 nptr 中第一個無法辨認為數字的一部分的字元時停止讀取。這可能是終止的 null 字元，或者它可能是大於或等於 base 的第一個數字字元。地區設定的 LC_NUMERIC 分類設定決定如何辨認目前 nptr中的基數字元。如需更多的資訊，請參閱地區設定。 strtoul 和 wcstoul 使用目前的地區設定；_strtoul_l 和 _wcstoul_l 也是相同，不過取而代之改用傳入的地區設定。如需詳細資訊，請參閱地區設定。

如果 endptr 不是 NULL，停止掃描的字元的指標會儲存在 endptr 所指向的位置。如果轉換無法執行 (未找到有效的數字或指定了無效基底)， nptr 的值會儲存在 endptr 所指向的位置。

wcstoul 是 strtoul 的寬字元版本。它的 nptr 參數是寬字元字串。否則，這三個函式的行為相同。

一般文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoul 預期 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」字元將會停止掃描。 strtoul 允許加 (+) 或減 (–) 號前置字元；前置減號指示傳回值為否定。