C++：atoi - MudSynth

atoi 是 C 标准库中的一个函数，用于将字符串转换为整数。尽管 atoi 函数主要属于 C 语言，但在 C++ 中也广泛使用。下面将详细解释 atoi 的基本用法、特点和注意事项，以及示例代码。

基本用法

atoi 函数用于将以数字形式表示的字符串转换为 int 类型的整数。

函数原型：

1	int atoi(const char *str);

参数：

str：指向以 null 结尾的字符串，该字符串表示一个整数。

返回值：

成功时：返回转换后的整数值。
失败时：返回 0，如果字符串不包含有效的数字。

特点和注意事项

输入字符串要求：
- atoi 只能处理纯数字字符串，可以包含可选的正负号。
- 输入字符串中不能包含非数字字符，否则结果可能不准确。
- 如果字符串为空或不包含有效的整数，atoi 会返回 0。
异常处理：
- atoi 不会检测转换过程中的溢出情况。例如，如果字符串表示的数字超出了 int 类型的范围，atoi 不会抛出错误或警告，只会返回未定义的行为。
安全替代：
- 由于 atoi 缺乏错误处理机制，建议使用更安全的替代函数，如 strtol 或 C++11 引入的 std::stoi，它们提供了更好的错误检测和处理能力。

示例代码

下面是一些示例代码，展示了如何使用 atoi 函数将字符串转换为整数：

#include <iostream>
#include <cstdlib> // 包含 atoi 函数的头文件

int main() {
    const char *numStr1 = "12345";
    const char *numStr2 = "-6789";
    const char *numStr3 = "42 is the answer";
    const char *numStr4 = "abc123";
    
    // 使用 atoi 将字符串转换为整数
    int num1 = atoi(numStr1);
    int num2 = atoi(numStr2);
    int num3 = atoi(numStr3);
    int num4 = atoi(numStr4);
    
    // 输出转换结果
    std::cout << "String: " << numStr1 << " -> Integer: " << num1 << std::endl;
    std::cout << "String: " << numStr2 << " -> Integer: " << num2 << std::endl;
    std::cout << "String: " << numStr3 << " -> Integer: " << num3 << std::endl; // 只转换前面的数字部分
    std::cout << "String: " << numStr4 << " -> Integer: " << num4 << std::endl; // 非数字开头，返回 0
    
    return 0;
}

输出：

String: 12345 -> Integer: 12345
String: -6789 -> Integer: -6789
String: 42 is the answer -> Integer: 42
String: abc123 -> Integer: 0

总结

atoi 是一个简单但不够健壮的字符串到整数转换函数，适用于处理纯数字字符串。由于缺乏错误处理机制和安全性问题，建议在实际开发中使用更安全的替代函数，如 strtol 或 std::stoi。