strtoimax
在头文件<inttypes.h>中定义 | ? | ? |
---|---|---|
intmax_t strtoimax(const char * restrict nptr,char ** restrict endptr,int base); | ? | (自C99以来) |
uintmax_t strtoumax(const char * restrict nptr,char **限制endptr,int base); | ? | (自C99以来) |
解释由nptr指向的字节字符串中的整数值。
放弃任何空白字符(如调用isspace()所标识的)直到找到第一个非空白字符,然后接收尽可能多的字符以形成有效的base-n(其中n = base)整数表示并将它们转换为 一个整数值。 有效的整数值由以下部分组成:
- (可选)加号或减号
- (可选)prefix(
0
)指示八进制基数(只适用于基数为8
或?0?
) - (可选)前缀(
0x
或0X
)表示十六进制基数(仅适用于基数为16
或?0?
) - 数字序列
base的有效值集合是{0,2,3,...,36}。base-2整数的有效数字集合是{0,1
},对于base-3整数是{0,1,2
},依此类推。对于大于等于的基数10
,有效数字包含字母字符,从Aa
基数为11的整数开始,到Zz
基数为36的整数。字符的情况被忽略。
其他数字格式可以被当前安装的C语言环境接受。
如果base的值是?0?,则数字基数将自动检测:如果前缀为0,则基数为八进制数,如果前缀为0x或0X,则基数为十六进制数,否则基数为十进制数。
如果减号是输入序列的一部分,则根据数字序列计算的数值将被否定,如同在结果类型中使用一元减号一样。
这些函数将endptr指向的指针设置为指向最后解释的字符之后的字符。 如果endptr是NULL,它将被忽略。
如果nptr为空或者没有预期的形式,则不执行转换,并且(如果enptr不为NULL),则nptr的值将存储在endptr所指向的对象中。
参数
NPTR | - | 指向要解释的以空字符结尾的字节字符串 |
---|---|---|
endptr | - | 指向字符的指针。 |
base | - | 解释的整数值的基数 |
返回值
- 如果成功,则返回对应于str内容的整数值。
- 如果转换值超出相应返回类型的范围,则会发生范围错误(将[[cpp / error / errno | errno]]设置为ERANGE),并根据情况返回INTMAX_MAX,INTMAX_MIN,UINTMAX_MAX或0。
- 如果不能执行转换,则返回0。
例
#include <stdio.h>
#include <inttypes.h>
#include <errno.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
参考
- 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) | 将字节字符串转换为无符号整数值(函数) |
| 针对strtoimax,strtoumax的C ++文档 |
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com