strtoimax, strtoumax

将 nptr 所指向的字节字符串中的整数值进行解析。

丢弃所有空白字符（通过调用 isspace 识别），直到找到第一个非空白字符，然后尽可能多地提取字符以构成有效的 base-n （其中n= base ）整数表示形式，并将其转换为整数值。有效的整数值由以下部分组成：

• (可选) 正负号
• (可选) 前缀 ( 0 ) 表示八进制基数（仅当基数为 8 或 ​ 0 ​ 时适用）
• (可选) 前缀 ( 0x 或 0X ) 表示十六进制基数（仅当基数为 16 或 ​ 0 ​ 时适用）
• 数字序列

基数的有效取值范围为 {0, 2, 3, ..., 36} 。对于基数为 2 的整数，有效数字集为 {0, 1} ；对于基数为 3 的整数，有效数字集为 {0, 1, 2} ，依此类推。对于大于 10 的基数，有效数字包含字母字符：从基数为 11 的整数使用 Aa 开始，到基数为 36 的整数使用 Zz 结束。字符的大小写将被忽略。

当前安装的 C locale 可能接受其他数字格式。

如果 base 的值为 ​ 0 ​ ，将自动检测数值进制：若前缀为 0 则为八进制，若前缀为 0x 或 0X 则为十六进制，否则为十进制。

如果减号是输入序列的一部分，则从数字序列计算得出的数值将被取反，如同通过结果类型的 一元减号 运算符处理。

该函数将 endptr 所指向的指针设置为指向最后一个被解释字符之后的位置。如果 endptr 是空指针，则会被忽略。

如果 nptr 为空或不具有预期格式，则不执行转换，并且（若 endptr 不是空指针）将 nptr 的值存入 endptr 所指向的对象。

参数

返回值

• 若成功，则返回与 str 内容对应的整数值。
• 若转换值超出对应返回类型的范围，则发生范围错误（将 errno 设为 ERANGE ），并返回 INTMAX_MAX 、 INTMAX_MIN 、 UINTMAX_MAX 或 ​ 0 ​ （视具体情况而定）。
• 若无法执行转换，则返回 ​ 0 ​ 。

示例

#include <errno.h>
#include <inttypes.h>
#include <stdio.h>
#include <string.h>
int main(void)
{
    char* endptr = NULL;
    printf("%ld\n", strtoimax(" -123junk", &endptr, 10)); // 十进制
    printf("%ld\n", strtoimax("11111111", &endptr, 2));   // 二进制
    printf("%ld\n", strtoimax("XyZ", &endptr, 36));       // 三十六进制
    printf("%ld\n", strtoimax("010", &endptr, 0));        // 八进制自动检测
    printf("%ld\n", strtoimax("10", &endptr, 0));         // 十进制自动检测
    printf("%ld\n", strtoimax("0x10", &endptr, 0));       // 十六进制自动检测
    // 范围错误：LONG_MAX+1 --> LONG_MAX
    errno = 0;
    printf("%ld\n", strtoimax("9223372036854775808", &endptr, 10));
    printf("%s\n", strerror(errno));
}

-123
255
44027
8
10
16
9223372036854775807
Numerical result out of range

参考文献

参见