01 基本概念与数据类型
01-1 字符串到数值的基本转换
本节帮助你理解 C++string 转 int 的核心思路，涉及前导空格、符号处理以及非法字符的应对。了解这些将帮助你在后续章节中快速选择合适的转换方法。核心点是先完成对字符串的清洗，再选用合适的 API 完成转换。
在 C++ 中，字符串到数值的转换常见入口包括 std::stoi / std::stol / std::stoll、stringstream、以及 std::from_chars 等多种实现，适用于不同的场景与性能需求。选择合适的工具能降低出错概率并提升可读性。
需要特别关注的还有错误处理，对无效字符串通常会有异常抛出，而越界会抛出 std::out_of_range，因此应通过try/catch等机制进行鲁棒处理。
#include
#include int main() {std::string s = " -12345abc";int v = std::stoi(s, nullptr, 10);std::cout << v << std::endl;return 0;
}
在上述示例中，stoi 会忽略前导空格并处理符号，最终输出转换后的整型值。通过示例中的第二个参数，你可以得到转换结束的位置索引，从而对输入进行进一步的解析。
本节还需注意：idx 的存在帮助你定位未解析的尾部，便于后续自定义解析逻辑或错误提示。
01-2 常用的 stoi 系列函数及错误处理
std::stoi / std::stol / std::stoll 都提供了 base 参数，base=0 可以实现自动进制检测，如 0x 前缀表示十六进制，前缀 0 表示八进制，其他情况表示十进制。
下面的示例展示了如何通过 base=0 实现对不同进制的自动识别，以及如何读取转换后的位置索引。自动检测进制是一种常用技巧，便于处理来自文本的混合数字。
#include
#include int main() {std::string s = "0xff";size_t idx;int x = std::stoi(s, &idx, 0); // 自动检测 0x -> 十六进制std::cout << x << " (idx=" << idx << ")" << std::endl;return 0;
}
当输入为无效字符串时，invalid_argument 或 out_of_range 异常会被抛出，因此建议将转换放在try/catch块中以实现健壮性。
#include
#include int main() {try {std::string s = "abc";int v = std::stoi(s);} catch (const std::invalid_argument& e) {std::cout << "invalid argument: " << e.what() << std::endl;} catch (const std::out_of_range& e) {std::cout << "out of range: " << e.what() << std::endl;}return 0;
}
通过以上示例可以看到，异常处理策略直接影响到程序的健壮性，捕获特定异常类型有助于精确定位错误原因。
02 字符串流与从流读取
02-1 使用 stringstream 提取数值
stringstream 提供了一个<灵活的解析管道，你可以使用自然的读取操作符 operator>>来逐步提取数值，且支持前导空格和分隔符的自动处理，适合自定义解析流程。
在读取过程中，读取失败时应检查流状态（如 ss.fail()），以判断是否需要回退或报错。
#include
#include
#include int main() {std::string s = " 42 ";std::stringstream ss(s);int v;ss >> v;std::cout << v << std::endl;
}
如果输入包含非数字字符，读取过程可能在遇到第一个非数字字符时停止，随后可以通过检查 ss.fail() 或者 ss.eof() 来判定读取结果的有效性与完整性。
#include
#include
#include int main() {std::string s = "12x";std::stringstream ss(s);int v;ss >> v;if (ss.fail()) {std::cout << "读取失败" << std::endl;}
}
上述方法在可读性与灵活性方面有优势，但在性能敏感场景下可能不如 from_chars，尤其是在需要大规模解析时。
02-2 使用 std::from_chars（C++17 及以上）
from_chars 提供了无异常、低开销的字符串到数值转换，适合高性能场景，尤其是在需要大规模解析或嵌入式环境下。
该方法返回一个状态码，ec 为 std::errc()，表示是否完成转换以及是否出现错误，开发者需要据此分支逻辑。
#include
#include
#include int main() {std::string s = "12345";int v;auto [ptr, ec] = std::from_chars(s.data(), s.data() + s.size(), v);if (ec == std::errc()) {std::cout << v << std::endl;}
}
如果转换未完成或遇到错误，ec 将返回非零值，你可以据此进行错误处理或重试。
03 C 风格转换与 stoi 的对比
03-1 使用 atoi/strtol/strtoll
C 风格的接口提供了一个简洁的快速路径，其中 strtol 支持base、endptr、以及 errno 的错误信息，能在无需抛出异常的情况下完成转换。
通过 end 指针，你可以得到实际处理到的位置，以便进行后续文本处理或错误检测。
#include
#include
#include
#include int main() {const char* s = " 1024abc";char* end;errno = 0;long x = std::strtol(s, &end, 10);if (end == s) {std::cout << "没有转换" << std::endl;} else {std::cout << x << std::endl;}
}
与 C++ 的异常模型相比，C 风格的接口更依赖返回值、end 指针和 errno来判断转换结果，这在某些低层场景下更为直观和可控。
03-2 使用 strtol 的边界与错误处理
对于跨平台的边界处理，errno 与 ERANGE 提供了重要信息，结合 end 指针可以判断是否发生了溢出或无效输入。
#include
#include
#include int main() {const char* s = "999999999999999999999";char* end;errno = 0;long x = std::strtol(s, &end, 10);if (errno == ERANGE) {std::cout << "溢出" << std::endl;} else {std::cout << x << std::endl;}
}
04 多进制、边界、以及性能对比
04-1 自动进制检测与 base
在一些输入来自文本的场景中，base 参数为 0可以实现<强>自动进制检测，0x 前缀表示十六进制、0 前缀或没有前缀表示十进制，其他情况表示八进制或十进制，具体行为取决于实现。
下列示例展示了对十六进制数字字符串的自动检测转换，确保在不同进制之间获得正确结果。
#include
#include int main() {std::string s = "0x1A";int v = std::stoi(s, nullptr, 0);std::cout << v << std::endl;
}
需要注意的是，不同编译器对某些前缀的解析可能存在细微差异，因此在跨平台开发时应进行充分测试，并在文档中明确约定输入格式。
04-2 边界与性能要点
在高性能场景中，from_chars通常胜出，因为它无异常开销且具备稳定的内存访问模式，适合大规模解析任务。对于易于理解与维护的代码，stoi/stringstream 仍然是常用且直观的选择。
当你需要在有限资源的环境中解析大量数字时，尽量减少拷贝与分配，优先考虑 from_chars 或者在输入已经以字符缓冲区存在时直接使用它。
#include
#include
#include int main() {std::string s = "2147483647";int v;auto r = std::from_chars(s.data(), s.data() + s.size(), v);std::cout << (r.ec == std::errc()) << " value=" << v << std::endl;
}
05 最佳实践与性能考量
05-1 何时优先选择 from_chars
在无异常需求、需要低开销的场景下，优先考虑 std::from_chars，特别是当你面对大量数字解析任务时，这种方式能显著降低开销。
尽管 from_chars 具备高性能特性，但在需要对异常进行细粒度区分或对错误信息进行详细处理时，stoi/stringstream 的异常机制可能更直接、易于调试。
#include
#include
#include int main() {std::string s = "100";int v;auto [p, ec] = std::from_chars(s.data(), s.data() + s.size(), v);if (ec == std::errc()) std::cout << v;
}
05-2 使用 string_view 与避免不必要的字符串拷贝
当来自外部接口的数据已经存在于内存中，string_view 可以避免额外的拷贝，结合 from_chars 使用时更为高效。
以下示例演示如何通过 string_view 将数据区间传给 from_chars 进行解析，避免额外的字符串构造。
#include
#include
#include
#include int main() {std::string data = "256";std::string_view sv(data);int v;auto [p, ec] = std::from_chars(sv.data(), sv.data() + sv.size(), v);if (ec == std::errc()) std::cout << v;
}
06 错误处理与鲁棒性要点
06-1 如何优雅处理无效输入
对于 stoi、stringstream 等 C++ 风格的转换，异常处理是关键手段，使用try/catch可以针对不同错误类型做精细处理。
对于 C 风格接口，结合 end 指针 与 errno 的组合，可以在无异常情况下进行错误检测，提升容错能力。
#include
#include int main() {std::string s = "!";try {int v = std::stoi(s);} catch (const std::invalid_argument& e) {std::cout << "invalid: " << e.what() << std::endl;}
}
对于 C 风格函数，应关注 end 指针 是否落在起始位置，以及 errno 的设置，以判断是否进行了有效的转换。
#include
#include
#include int main() {const char* s = "999999999999999999999";char* end;errno = 0;long x = std::strtol(s, &end, 10);if (end == s) std::cout << "没有转换";
}
07 实战示例：将配置文件中的数值字段解析为整型
07-1 从一个配置字符串解析整数
在实际项目中，常常需要从配置字符串中提取整数，例如 "threads=4; timeout=30"。以下示例展示了如何使用 string、stringstream 和 stoi 将字段解析为整型。
通过示例你可以看到，分隔符处理、键值对匹配、以及对数值的最终赋值都可以在一个简洁的流程中完成。
#include
#include
#include int main() {std::string config = "threads=4; timeout=30";std::stringstream ss(config);std::string token;int threads = 0, timeout = 0;while (std::getline(ss, token, ';')) {auto pos = token.find('=');if (pos != std::string::npos) {std::string key = token.substr(0, pos);std::string val = token.substr(pos+1);if (key.find("threads") != std::string::npos) threads = std::stoi(val);if (key.find("timeout") != std::string_view::npos) timeout = std::stoi(val);}}std::cout << threads << " " << timeout << std::endl;
}
在这个流程中，错误处理的设计同样重要，确保在任一字段无法正确解析时能够给出明确的反馈或回退策略。
