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 ++文档 |