在线文档教程
C

strtoimax

strtoimax, strtoumax

在头文件中定义
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)整数表示并将它们转换为 一个整数值。 有效的整数值由以下部分组成:

  • (可选)加号或减号

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内容的整数值。

#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):

扩展内容

wcstoimaxwcstoumax(C99)(C99)将宽字符串转换为intmax_t或uintmax_t(函数)
strtolstrtoll(C99)将字节字符串转换为整数值(函数)
strtoul strtoull(C99)将字节字符串转换为无符号整数值(函数)

| 针对strtoimax,strtoumax的C ++文档 |