HOWTO · C

如何在 C 语言中把字符串转换为整数

本文介绍了在 C 语言中把字符串转换为整数的不同方法。

本页内容

将 C 字符串转换为整数,具体做法取决于你接受的输入以及程序需要执行的检查。标准库提供了 atoi()、strtol() 和 strtoumax()。只有在输入可信时才使用 atoi();如果输入可能格式错误,或数值可能超出目标类型的范围,应优先使用 strtol() 或 strtoumax() 并检查转换结果。

在 C 语言中使用 atoi() 将字符串转换为整数

atoi() 声明于 <stdlib.h>。它会跳过开头的空白字符,读取可选的正负号和十进制数字,然后在遇到第一个不属于数字的字符时停止。它返回 int,但其接口不会报告解析停止的位置,也无法区分有效的零值和转换失败。如果转换后的值无法用 int 表示,行为未定义。只有在输入格式和数值范围已有其他保证时,才应使用它。

运行以下示例:

本节中的代码以及显示的标签或输出仍为英文。

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *input = "123";
    int value = atoi(input);
    printf("%s -> %d\n", input, value);
    return 0;
}

观察到的输出:

123 -> 123

在 C 语言中使用 strtol() 将字符串转换为整数

strtol() 声明于 <stdlib.h>,返回 long。它接受 2 到 36 之间的进制:进制为 10 时读取十进制数,进制为 0 时识别常见的 C 整数前缀。它会跳过开头的空白字符,并在遇到第一个不属于数字的字符时停止。传入尾指针的地址即可找到停止位置。如果尾指针仍指向输入的第一个字符,说明没有转换任何数字;如果转换后它指向非空字符,则说明输入末尾还有其他字符。

调用 strtol() 前,将 errno 设为零。如果结果等于 LONG_MIN 或 LONG_MAX,且 errno == ERANGE,则表示数值超出了 long 的范围。如果目标类型是 int,还要在强制类型转换前检查数值是否位于 INT_MIN 和 INT_MAX 之间。以下完整示例只接受能够用 int 表示的完整十进制数:

本节中的代码以及显示的标签或输出仍为英文。

#include <errno.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *input = "123";
    char *end;
    errno = 0;
    long parsed = strtol(input, &end, 10);

    if (end == input || *end != '\0' || errno == ERANGE ||
        parsed < INT_MIN || parsed > INT_MAX) {
        puts("conversion failed");
        return 0;
    }

    printf("value=%d\n", (int)parsed);
    return 0;
}

观察到的输出:

value=123

在生产代码中,应明确是否允许输入包含空白或尾随字符;strtol() 本身允许开头有空白,而上面的尾指针检查会拒绝数字后的任何字符。

在 C 语言中使用 strtoumax() 将字符串转换为整数

strtoumax() 声明于 <inttypes.h>,可将字符串转换为 uintmax_t,这是实现所提供的最宽无符号整数类型。与 strtol() 类似,它接受尾指针和进制;调用前清除 errno 后,如果发生范围溢出,它会通过 errno == ERANGE 报告。uintmax_t 类型需要包含 <stdint.h>;该函数和 PRIuMAX 格式化宏需要包含 <inttypes.h>。

无符号转换可以接受开头的负号,并按照该函数的规则生成无符号结果。如果应用要求输入必须非负,应明确拒绝负号。下面的示例还要求输入至少包含一位数字,拒绝尾随字符,并使用匹配的格式化宏输出数值:

本节中的代码以及显示的标签或输出仍为英文。

#include <ctype.h>
#include <errno.h>
#include <inttypes.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *input = "123";
    const char *sign = input;
    while (isspace((unsigned char)*sign)) {
        ++sign;
    }

    if (*sign == '-') {
        puts("conversion failed");
        return 0;
    }

    char *end;
    errno = 0;
    uintmax_t value = strtoumax(input, &end, 10);
    if (end == input || *end != '\0' || errno == ERANGE) {
        puts("conversion failed");
        return 0;
    }

    printf("value=%" PRIuMAX "\n", value);
    return 0;
}

观察到的输出:

value=123

结果类型是无符号类型,而且可能比 int 更宽;转换为较窄的目标类型之前,应先检查数值是否超过该目标类型的最大值。

如何选择 C 字符串转整数函数

如果输入可信、数值可用 int 表示,并且程序无需区分格式错误的输入和零值,请选择 atoi()。对于用户输入、文件内容或其他可能不符合预期格式的数据,strtol() 通常是更合适的有符号转换函数,因为它的尾指针和 errno 可用于验证结果。还要检查 long 的范围,以及任何较窄目标类型的范围。

对于可能超过 long 正数范围的非负数值,请选择 strtoumax()。应验证是否读取到了数字;如果要求整个字符串都必须是数字,则拒绝尾随文本;检查 ERANGE,并执行应用对较窄类型设定的限制。两个带检查的函数都无法替应用决定哪些输入可以接受:调用方必须明确是否允许空白、正负号、前缀或尾随字符,并在使用结果前验证这些规则。