非常教程

C参考手册

字符串 | Strings

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()),直到找到第一个非空白字符,然后接收尽可能多的字符以形成有效的base-n(其中n = base)整数表示并将它们转换为整数值。有效的整数值由以下部分组成:

  • (可选)加号或减号
  • (可选)prefix(0)指示八进制基数(只适用于基数为8​0​
  • (可选)前缀(0x0X)表示十六进制基数(仅适用于基数为16​0​
  • 数字序列

base的有效值集合是{0,2,3,...,36}。base-2整数的有效数字集合是{0,1},对于base-3整数是{0,1,2},依此类推。对于大于等于的基数10,有效数字包含字母字符,从Aa基数为11的整数开始,到Zz基数为36的整数。字符的情况被忽略。

其他数字格式可以被当前安装的C语言环境接受。

如果基数的值是​0​,数字基地是自动检测:如果前缀是0,基地是八进制的,如果前缀是0x0X,基地是十六进制,否则基数是十进制。

如果减号是输入序列的一部分,则根据数字序列计算的数值将被否定,如同在结果类型中使用一元减号一样。

这些函数将endptr指向的指针设置为指向最后解释的字符之后的字符。 如果endptr是NULL,它将被忽略。

如果nptr为空或者没有预期的形式,则不执行转换,并且(如果enptr不为NULL),则nptr的值将存储在endptr所指向的对象中。

参数

NPTR

-

指向要解释的以空字符结尾的字节字符串

endptr

-

指向字符的指针。

base

-

解释的整数值的基数

返回值

  • 如果成功,则返回与内容相对应的整数值str
  • 如果转换后的值脱离的相应返回类型的范围时,发生错误的范围(设定[[CPP /错误/错误号| errno]]到ERANGE)和INTMAX_MAXINTMAX_MINUINTMAX_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 ++文档 |

C

C 语言是一门通用计算机编程语言,应用广泛。C 语言的设计目标是提供一种能以简易的方式编译、处理低级存储器、产生少量的机器码以及不需要任何运行环境支持便能运行的编程语言。