strtoimax, strtoumax

定义在头文件 `<inttypes.h>` 中
intmax_t strtoimax( const char restrict nptr, char *restrict endptr, int base );		(自 C99)
uintmax_t strtoumax( const char restrict nptr, char *restrict endptr, int base );		(自 C99)

解释由 nptr 指向的字节字符串中的整数值。

丢弃任何空白字符（通过调用 isspace 识别）直到找到第一个非空白字符，然后尽可能多地获取字符以形成有效的n进制（其中 n=base）整数表示，并将它们转换为整数值。有效整数值包含以下部分

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

基数的有效值集为 {0,2,3,...,36}. 基数为 2 的整数的有效数字集为 {0,1}, 基数为 3 的整数的有效数字集为 {0,1,2}, 等等。对于大于 10 的基数，有效数字包括字母字符，从 Aa 开始表示基数为 11 的整数，到 Zz 表示基数为 36 的整数。字符的大小写被忽略。

当前安装的 C 区域设置可能接受其他数值格式。

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

如果负号是输入序列的一部分，则从数字序列计算出的数值将被取反，就像在结果类型中使用一元减号一样。

这些函数将 endptr 指向的指针设置为指向最后一个解释的字符之后的字符。如果 endptr 是一个空指针，则忽略它。

如果 nptr 为空或没有预期的格式，则不会执行任何转换，并且（如果 endptr 不是空指针）nptr 的值将存储在 endptr 指向的对象中。

[编辑] 参数

nptr	-	指向要解释的以空字符结尾的字节字符串的指针
endptr	-	指向字符指针的指针。
base	-	解释的整数值的基数

[编辑] 返回值

如果成功，则返回与 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;
 
    printf("%ld\n", strtoimax(" -123junk",&endptr,10)); /* base 10                    */
    printf("%ld\n", strtoimax("11111111",&endptr,2));   /* base 2                     */
    printf("%ld\n", strtoimax("XyZ",&endptr,36));       /* base 36                    */
    printf("%ld\n", strtoimax("010",&endptr,0));        /* octal auto-detection       */
    printf("%ld\n", strtoimax("10",&endptr,0));         /* decimal auto-detection     */
    printf("%ld\n", strtoimax("0x10",&endptr,0));       /* hexadecimal auto-detection */
 
    /* range error             */
    /* LONG_MAX+1 --> LONG_MAX */
    errno = 0;
    printf("%ld\n", strtoimax("9223372036854775808",&endptr,10));
    printf("%s\n", strerror(errno));
 
    return 0;
}

输出

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

[编辑] 参考资料

C23 标准 (ISO/IEC 9899:2024)

7.8.2.3 strtoimax 和 strtoumax 函数 (p: TBD)

C17 标准 (ISO/IEC 9899:2018)

7.8.2.3 strtoimax 和 strtoumax 函数 (p: TBD)

C11 标准 (ISO/IEC 9899:2011)

7.8.2.3 strtoimax 和 strtoumax 函数 (p: 219)

C99 标准 (ISO/IEC 9899:1999)

7.8.2.3 strtoimax 和 strtoumax 函数 (p: 200)

[编辑] 另请参见

wcstoimaxwcstoumax (C99)(C99)	将宽字符串转换为 intmax_t 或 uintmax_t (函数) [编辑]
strtolstrtoll (C99)	将字节字符串转换为整数值 (函数) [编辑]
strtoul strtoull (C99)	将字节字符串转换为无符号整数值 (函数) [编辑]
C++ 文档 for strtoimax, strtoumax

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

cppreference.com

命名空间

变体

视图

操作