strtoul, strtoull

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

字串庫

空終止位元組字串

空終止多位元組字串

空終止寬字串

 

空終止位元組字串

函式
字元操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
與數字格式相互轉換
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字串檢查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
記憶體操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
雜項
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

在標頭檔案 <stdlib.h> 中定義
unsigned long      strtoul( const char*          str, char**          str_end,                             int base );		(直到 C99)
unsigned long      strtoul( const char* restrict str, char** restrict str_end,                             int base );		(C99 起)
unsigned long long strtoull( const char* restrict str, char** restrict str_end,                              int base );		(C99 起)

解析指向 str 的位元組字串中的無符號整數值。

丟棄任何空白字元（透過呼叫 isspace 識別），直到找到第一個非空白字元，然後儘可能多地獲取字元以形成有效的 base-n（其中 n=base）無符號整數表示，並將其轉換為整數值。有效的無符號整數值包含以下部分

• (可選) 加號或減號
• (可選) 字首 (0) 表示八進位制基數 (僅當基數為 8 或 ​0​ 時適用)
• (可選) 字首 (0x 或 0X) 表示十六進位制基數 (僅當基數為 16 或 ​0​ 時適用)
• 一系列數字

base 的有效值集合是 {0, 2, 3, ..., 36}。對於 base-2 整數，有效數字集合是 {0, 1}；對於 base-3 整數，有效數字集合是 {0, 1, 2}，依此類推。對於大於 10 的基數，有效數字包括字母字元，從 base-11 整數的 Aa 到 base-36 整數的 Zz。字元的大小寫被忽略。

當前安裝的 C 區域設定可能會接受其他數字格式。

如果 base 的值為 ​0​，則自動檢測數字基數：如果字首是 0，則基數是八進位制；如果字首是 0x 或 0X，則基數是十六進位制；否則基數是十進位制。

如果減號是輸入序列的一部分，則從數字序列計算出的數值將被否定，如同結果型別中的一元減號一樣，這將應用無符號整數環繞規則。

函式將 str_end 指向的指標設定為指向已解釋字元之後的字元。如果 str_end 是空指標，則忽略它。

引數

str	-	指向要解釋的空終止位元組字串的指標
str_end	-	指向字元指標的指標，可能被設定為已解釋字元之後的位置
base	-	被解釋整數值的*基數*

返回值

成功時，對應於 str 內容的整數值。如果轉換後的值超出相應返回型別的範圍，則發生範圍錯誤（errno 被設定為 ERANGE），並返回 ULONG_MAX 或 ULLONG_MAX。如果無法執行轉換，則返回 ​0​。

示例

執行此程式碼

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    const char* p = "10 200000000000000000000000000000 30 -40 - 42";
    printf("Parsing '%s':\n", p);
    char* end = NULL;
    for (unsigned long i = strtoul(p, &end, 10);
         p != end;
         i = strtoul(p, &end, 10))
    {
        printf("'%.*s' -> ", (int)(end - p), p);
        p = end;
        if (errno == ERANGE)
        {
            errno = 0;
            printf("range error, got ");
        }
        printf("%lu\n", i);
    }
    printf("After the loop p points to '%s'\n", p);
}

輸出

Parsing '10 200000000000000000000000000000 30 -40 - 42':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 18446744073709551615
' 30' -> 30
' -40' -> 18446744073709551576
After the loop p points to ' - 42'

參考

• C23 標準 (ISO/IEC 9899:2024)

• 7.24.1.7 strtol、strtoll、strtoul 和 strtoull 函式 (p: TBD)

• C17 標準 (ISO/IEC 9899:2018)

• 7.22.1.4 strtol、strtoll、strtoul 和 strtoull 函式 (p: 251-252)

• C11 標準 (ISO/IEC 9899:2011)

• 7.22.1.4 strtol、strtoll、strtoul 和 strtoull 函式 (p: 344-345)

• C99 標準 (ISO/IEC 9899:1999)

• 7.20.1.4 strtol、strtoll、strtoul 和 strtoull 函式 (p: 310-311)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.10.1.6 strtoul 函式

另請參閱

wcstoulwcstoull (C95)(C99)	將寬字串轉換為無符號整數值 (函式)
atoiatolatoll (C99)	將位元組字串轉換為整數值 (函式)
strtolstrtoll (C99)	將位元組字串轉換為整數值 (函式)
C++ 文件 用於 strtoul