頭文件:#include <stdlib.h>
strtoul() 函數源自於“string to unsigned long”,用來將字符串轉換成無符號長整型數(unsigned long),其原型為:
unsigned long strtoul (const char* str, char** endptr, int base);
【參數說明】str 為要轉換的字符串,endstr 為第一個不能轉換的字符的指針,base 為字符串 str 所采用的進制。
【函數說明】strtoul() 會將參數 str 字符串根據參數 base 來轉換成無符號的長整型數(unsigned long)。參數 base 范圍從2 至36,或0。參數 base 代表 str 采用的進制方式,如 base 值為10 則采用10 進制,若 base 值為16 則采用16 進制數等。
strtoul() 會掃描參數 str 字符串,跳過前面的空白字符(例如空格,tab縮進等,可以通過 isspace() 函數來檢測),直到遇上數字或正負符號才開始做轉換,再遇到非數字或字符串結束時('\0')結束轉換,並將結果返回。
兩點注意:
- 當 base 的值為 0 時,默認采用 10 進制轉換,但如果遇到 '0x' / '0X' 前置字符則會使用 16 進制轉換,遇到 '0' 前置字符則會使用 8 進制轉換。
- 若 endptr 不為NULL,則會將遇到的不符合條件而終止的字符指針由 endptr 傳回;若 endptr 為 NULL,則表示該參數無效,或不使用該參數。本文最后的范例沒有展示 endptr 參數的使用,你可以參考 strtol() 函數的范例來更加直觀地了解 endptr 參數。
【返回值】返回轉換后的無符號長整型數;如果不能轉換或者 str 為空字符串,那么返回 0;如果轉換得到的值超出unsigned long int 所能表示的范圍,函數將返回 ULONG_MAX(在 limits.h 頭文件中定義),並將 errno 的值設置為 ERANGE。
溫馨提示:ANSI C 規范定義了 stof()、atoi()、atol()、strtod()、strtol()、strtoul() 共6個可以將字符串轉換為數字的函數,大家可以對比學習。另外在 C99 / C++11 規范中又新增了5個函數,分別是 atoll()、strtof()、strtold()、strtoll()、strtoull(),在此不做介紹,請大家自行學習。
范例:將輸入的字符串轉換為無符號長整型。
- #include <stdio.h>
- #include <stdlib.h>
- int main ()
- {
- char buffer [256];
- unsigned long ul;
- printf ("Enter an unsigned number: ");
- fgets (buffer, 256, stdin);
- ul = strtoul (buffer, NULL, 0);
- printf ("Value entered: %lu.\n", ul);
- system("pause");
- return 0;
- }
運行結果:
Enter an unsigned number: 017cyuyan
Value entered: 15.
由於 base 參數被設置為 0 並且字符串“017cyuyan”以“0”開頭,所以采用 8 進制轉換。