标准库标头＜charconv＞（c++17）学习

本文主要是介绍标准库标头＜charconv＞（c++17）学习，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

此头文件是strings library.

std::to_chars_result 是 std::to_chars 的返回类型。它没有基类，并且只有以下成员。

数据成员

成员名字	定义
ptr	char* 类型的指针 (公开成员对象)
ec	std::errc 类型的错误码 (公开成员对象)

std::from_chars_result 是 std::from_chars 的返回类型。它没有基类，并且只有以下成员。

数据成员

成员名字	定义
ptr	const char* 类型的指针 (公开成员对象)
ec	std::errc 类型的错误码 (公开成员对象)

类型声明

namespace std {// 初等数值转换的浮点格式enum class chars_format {scientific = /* 未指定 */,fixed = /* 未指定 */,hex = /* 未指定 */,general = fixed | scientific};// 初等数值输出转换struct to_chars_result { // 独立char* ptr;errc ec;friend bool operator==(const to_chars_result&, const to_chars_result&) = default;constexpr explicit operator bool() const noexcept { return ec == errc{}; }};to_chars_result to_chars(char* first, char* last, // 独立/* integer-type */ value, int base = 10);to_chars_result to_chars(char* first, char* last, // 独立bool value, int base = 10) = delete;to_chars_result to_chars(char* first, char* last, // 独立/* floating-point-type */ value);to_chars_result to_chars(char* first, char* last, // 独立/* floating-point-type */ value, chars_format fmt);to_chars_result to_chars(char* first, char* last, // 独立/* floating-point-type */ value,chars_format fmt, int precision);// 初等数值输入转换struct from_chars_result { // 独立const char* ptr;errc ec;friend bool operator==(const from_chars_result&, const from_chars_result&) = default;constexpr explicit operator bool() const noexcept { return ec == errc{}; }};constexprfrom_chars_result from_chars(const char* first, // 独立const char* last, /* integer-type */& value,int base = 10);from_chars_result from_chars(const char* first, // 独立或被删除const char* last, /* floating-point-type */& value,chars_format fmt = chars_format::general);
}

类
chars_format (C++17)	指定 std::to_chars 和 std::from_chars 所用的格式 (枚举)
from_chars_result (C++17)	std::from_chars 的返回类型 (类)
to_chars_result (C++17)	std::to_chars 的返回类型 (类)
函数
from_chars (C++17)	转换字符序列到整数或浮点值 (函数)
to_chars (C++17)	转换整数或浮点值为字符序列 (函数)

示例代码：

#include <array>
#include <charconv>
#include <iostream>
#include <string_view>
#include <system_error>
#include <cassert>
#include <iomanip>
#include <optional>//c++20
void show_to_chars(auto... format_args)
{std::array<char, 10> str;#if __cpp_lib_to_chars >= 202306L// 使用 C++26 operator bool() 进行错误检查if (auto res = std::to_chars(str.data(), str.data() + str.size(), format_args...))std::cout << std::string_view(str.data(), res.ptr) << '\n';elsestd::cout << std::make_error_code(res.ec).message() << '\n';
#elseif (auto [ptr, ec]= std::to_chars(str.data(), str.data() + str.size(), format_args...);ec == std::errc())std::cout << std::string_view(str.data(), ptr) << '\n';elsestd::cout << std::make_error_code(ec).message() << '\n';
#endif
}int main()
{//to_chars exampleshow_to_chars(42);show_to_chars(+3.14159F);show_to_chars(-3.14159, std::chars_format::fixed);show_to_chars(-3.14159, std::chars_format::scientific, 3);show_to_chars(3.1415926535, std::chars_format::fixed, 10);//form_chars examplefor (std::string_view const str : {"1234", "15 foo", "bar", " 42", "5000000000"}){std::cout << "字符串: " << std::quoted(str) << ". ";int result{};auto [ptr, ec] = std::from_chars(str.data(), str.data() + str.size(), result);if (ec == std::errc())std::cout << "结果: " << result << ", ptr -> " << std::quoted(ptr) << '\n';else if (ec == std::errc::invalid_argument)std::cout << "这不是数值。\n";else if (ec == std::errc::result_out_of_range)std::cout << "这个数值大于 int。\n";}// C++23 的 constexpr from_char 演示 / C++26 的 operator bool() 演示:auto to_int = [](std::string_view s) -> std::optional<int>{int value{};
#if __cpp_lib_to_chars >= 202306Lif (std::from_chars(s.data(), s.data() + s.size(), value))
#elseif (std::from_chars(s.data(), s.data() + s.size(), value).ec == std::errc{})
#endifreturn value;elsereturn std::nullopt;};assert(to_int("42") == 42);assert(to_int("foo") == std::nullopt);
#if __cpp_lib_constexpr_charconv and __cpp_lib_optional >= 202106static_assert(to_int("42") == 42);static_assert(to_int("foo") == std::nullopt);
#endif}

运行结果：