C++17 中的 std::to_chars 和 std::from_chars：高效且安全的字符串转换工具

文章目录

- 1. 传统转换方法的局限性
- 2. std::to_chars：数值到字符串的高效转换
- - 函数原型：
  - 返回值：
  - 示例代码：
  - 输出：
- 3. std::from_chars：字符串到数值的高效解析
- - 函数原型：
  - 返回值：
  - 示例代码：
  - 输出：
- 4. 新特性的优势
- 5. 注意事项
- 6. 总结

在现代 C++ 开发中，字符串与数值之间的转换是一个常见的需求，尤其是在处理输入输出、数据解析和格式化时。C++17 引入了 std::to_chars 和 std::from_chars，这两个函数为开发者提供了高效、安全且灵活的字符串转换工具。

1. 传统转换方法的局限性

在 C++17 之前，开发者主要依赖以下几种方法进行字符串与数值的转换：

std::stringstream：使用方便，但性能较低，因为涉及复杂的内部缓冲和格式化过程。
sprintf 和 snprintf：灵活但缺乏类型安全性，容易导致缓冲区溢出等安全问题。
std::to_string 和 std::stoi：简单易用，但性能一般，且缺乏对特殊格式的支持。

这些传统方法在高性能和高安全性要求的场景下表现不佳，促使 C++ 标准委员会引入了新的字符串转换工具。

2. std::to_chars：数值到字符串的高效转换

std::to_chars 是一个低级别的数值到字符串的转换函数，旨在提供高性能和高效的转换能力。

函数原型：

template<class T>
std::to_chars_result to_chars(char* first, char* last, T value, int base = 10);

first 和 last 指向目标缓冲区的起始和结束位置。
value 是要转换的数值。
base 是转换的进制，默认为 10。

返回值：

返回一个 std::to_chars_result 结构体，包含两个成员：

ptr：指向写入字符串后的下一个位置。
ec：错误码，使用 std::errc 枚举表示可能的错误类型。

示例代码：

#include <charconv>
#include <iostream>
#include <system_error>

int main() {
    int value = 12345;
    char buffer[20];
    auto result = std::to_chars(buffer, buffer + sizeof(buffer), value);

    if (result.ec == std::errc()) {
        std::cout << "转换成功: " << std::string(buffer, result.ptr) << std::endl;
    } else {
        std::cerr << "转换失败: " << static_cast<int>(result.ec) << std::endl;
    }

    return 0;
}

输出：

转换成功: 12345

3. std::from_chars：字符串到数值的高效解析

std::from_chars 是一个低级别的字符串到数值的解析函数，旨在提供高效和可靠的解析能力。

函数原型：

template<class T>
std::from_chars_result from_chars(const char* first, const char* last, T& value, int base = 10);

first 和 last 指向要解析的字符串的起始和结束位置。
value 是存储解析结果的变量。
base 是解析的进制，默认为 10。

返回值：

返回一个 std::from_chars_result 结构体，包含两个成员：

ptr：指向解析结束后的下一个位置。
ec：错误码，使用 std::errc 枚举表示可能的错误类型。

示例代码：

#include <charconv>
#include <iostream>
#include <system_error>

int main() {
    const char* str = "6789";
    int num;
    auto result = std::from_chars(str, str + 4, num);

    if (result.ec == std::errc()) {
        std::cout << "解析成功: " << num << std::endl;
    } else {
        std::cerr << "解析失败: " << static_cast<int>(result.ec) << std::endl;
    }

    return 0;
}

输出：

解析成功: 6789

4. 新特性的优势

性能提升：std::to_chars 和 std::from_chars 采用无缓冲、无异常抛出的设计，直接操作指针，避免了不必要的中间缓冲区和数据复制。
类型安全与错误处理：通过模板参数明确指定目标类型，减少了类型转换错误的风险。
灵活的格式控制：支持多种进制和格式选项。
无异常抛出：更适合在高性能和低延迟要求的系统中使用。