strtoul, strtoull

定义于头文件 `<stdlib.h>`
unsigned long strtoul( const char* str, char** str_end, int base );		(until C99)
unsigned long strtoul( const char* restrict str, char** restrict str_end, int base );		(since C99)
unsigned long long strtoull( const char* restrict str, char** restrict str_end, int base );		(since 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 locale 可能会接受其他数字格式。

如果 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 函数 (页码：待定)

C17 标准 (ISO/IEC 9899:2018)

7.22.1.4 strtol、strtoll、strtoul 和 strtoull 函数 (页码：251-252)

C11 标准 (ISO/IEC 9899:2011)

7.22.1.4 strtol、strtoll、strtoul 和 strtoull 函数 (页码：344-345)

C99 标准 (ISO/IEC 9899:1999)

7.20.1.4 strtol、strtoll、strtoul 和 strtoull 函数 (页码：310-311)

C89/C90 标准 (ISO/IEC 9899:1990)

4.10.1.6 strtoul 函数

[编辑] 参见

wcstoulwcstoull (C95)(C99)	将宽字符串转换为无符号整数值 (函数) [编辑]
atoiatolatoll (C99)	将字节字符串转换为整数值 (函数) [编辑]
strtolstrtoll (C99)	将字节字符串转换为整数值 (函数) [编辑]
C++ 中 strtoul 的文档 for strtoul

编译器支持
语言
头文件
类型支持
程序实用工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间实用工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.cn

命名空间

变体

视图

操作