strtoimax, strtoumax
来自 cppreference.cn
| 定义于头文件 <inttypes.h> |
||
| intmax_t strtoimax( const char* restrict nptr, char** restrict endptr, int base ); |
(1) | (C99 起) |
| uintmax_t strtoumax( const char* restrict nptr, char** restrict endptr, int base ); |
(2) | (C99 起) |
解释由 nptr 指向的字节字符串中的整数值。
丢弃任何空白字符（通过调用 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，则基数为十六进制；否则基数为十进制。
如果减号是输入序列的一部分，则从数字序列计算出的数值将被取反，就像结果类型中的 一元减号 一样。
这些函数将 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 = NULL; 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)); }
输出
-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)
[编辑] 参见
| (C99)(C99) |
将宽字符串转换为 intmax_t 或 uintmax_t (函数) |
| (C99) |
将字节字符串转换为整数值 (函数) |
| (C99) |
将字节字符串转换为无符号整数值 (函数) |
| C++ 文档 for strtoimax, strtoumax
| |
