C++ atoi()函数用法详解：语法、处理逻辑与异常判断

核心功能与头文件

`atoi()` 函数的主要作用是将以空字符 '\0' 结尾的数字格式字符串转换为对应的 int 类型整数。在使用该函数前，必须确保代码包含正确的头文件：

#include <cstdlib>
// 或者 C风格写法 #include <stdlib.h>

函数签名与基本用法

该函数的标准定义如下：

int atoi(const char* str);

• 参数 str：指向待转换的 C 风格字符串的指针。
• 返回值：转换成功后返回对应的整数；若无法转换，通常返回 0。

第1步：理解参数的解析规则

atoi() 在处理输入字符串时遵循特定的格式逻辑：[空格][符号][数字]。

• 空白字符：函数会自动跳过字符串开头的任意空白字符（如空格、制表符）。
• 符号位：紧接着空白字符后，可识别正号 "+" 或负号 "-"。
• 数字部分：读取连续的十进制数字进行计算。

以下情况均属于合法的调用形式：

atoi("  +123");  // 结果为 123
atoi(" -456");   // 结果为 -456
atoi("789");     // 结果为 789

注意：一旦遇到非数字字符（且不是前导空格或首位符号），函数会立即停止解析并返回已累积的结果。如果遇到 '\0' 结束符，同样终止并返回。

第2步：处理整数溢出异常

由于返回值类型为 int，当输入的数值范围超出系统支持的 int 边界时，会发生上溢或下溢。此时函数不会抛出异常，而是根据溢出方向返回极限值：

• 上溢（超出上限）：返回 INT_MAX (通常为 2147483647)。
• 下溢（超出下限）：返回 INT_MIN (通常为 -2147483648)。

检测溢出的示例代码：

const char* str1 = " 3336402735171707160320";
int value1 = atoi(str1);
if (value1 == INT_MAX) {
    printf("数值过大，发生上溢\n");
}

const char* str2 = " -3336402735171707160320";
int value2 = atoi(str2);
if (value2 == INT_MIN) {
    printf("数值过小，发生下溢\n");
}

第3步：准确判断转换状态

由于转换失败（如开头为非数字字母）也常返回 0，直接检查返回值难以区分是“转换结果为0”还是“完全无法转换”。推荐使用全局变量 errno 来辅助验证。使用前需引入 <cerrno>：

1. 在调用 atoi() 之前，将 errno 重置为 0。
2. 执行转换操作。
3. 检查 errno。如果发生范围越界，系统会将 errno 设置为 ERANGE。

#include <cstdlib>
#include <cerrno>

void check_conversion(const char* input) {
    errno = 0; // 关键步骤：清空错误状态
    int result = atoi(input);
    
    if (errno == ERANGE) {
        fprintf(stderr, "转换失败：数字超出了 int 的范围\n");
    } else if (result == 0 && *input != '0') {
        // 特殊处理：结果虽为0但并非由'0'引起，可能是非法字符导致
        if (*input != '+' && *input != '-' && isdigit(*input)) {
             fprintf(stderr, "转换失败：起始字符不合法\n");
        }
    } else {
        printf("转换成功: %d\n", result);
    }
}

宽字符版本支持

如果您的项目需要处理 Unicode 宽字符串，可以使用对应的宽字符版本函数：

int _wtoi(const wchar_t* str);

其参数 wchar_t* 的含义与处理方式与 atoi() 类似，但能解析包含宽字符编码的字符串。

简要总结

`atoi()` 适用于简单的字符串转整数场景，能够自动忽略前导空白和正负号。但在生产环境中，建议始终配合 errno 进行溢出检查，以避免隐藏的数据截断问题。以上就是对C++ atoi()函数用法的详细内容，更多关于C++字符串转换的资料请关注本站其它相关文章！