C++如何使用std::format自定义复杂结构体输出-C++-PHP中文网

必须手动特化std::formatter，且需在结构体同命名空间内；特化需继承基础formatter、实现constexpr parse()和format()，后者用std::format_to写入ctx.out()。

c++如何使用std::format自定义复杂结构体输出

std::format 要求类型可格式化，结构体默认不满足

直接对自定义结构体调用 std::format 会编译失败，报错类似：no matching function for call to 'format' 或更具体的 formatter specialization not found。这是因为 std::format 依赖 ADL 查找特化的 std::formatter 模板，而普通 struct 没有提供这个特化。

必须手动为结构体特化 std::formatter，且该特化需在对应命名空间内（通常与结构体同名空间），否则 ADL 找不到。

如何编写 std::formatter 特化

特化需继承 std::formatter<:string_view></:string_view>（或其它基础 formatter）并实现 parse() 和 format() 成员函数。关键点：

parse() 负责解析格式说明符（如 "{:x}" 中的 x），返回迭代器位置；若忽略格式控制，可只做基本校验
format() 接收 format_context&，用 ctx.out() 写入格式化后的字符序列，返回 ctx.out()
必须声明为 constexpr（C++23 起要求，Clang/GCC 13+ 已强制）
若结构体含非 trivially-copyable 成员（如 std::string），format() 内部不能用 std::to_chars 等低层 API 直接写内存，应统一走 std::format_to 或 std::format

示例：为 Point 结构体添加十六进制坐标输出支持

struct Point {
    int x, y;
};
<p>template
struct std::formatter<point> : std::formatter<:string_view> {
constexpr auto parse(format_parse_context& ctx) -> decltype(ctx.begin()) {
auto it = ctx.begin();
if (it != ctx.end() && *it == 'x') {
++it; // consume 'x'
}
return it;
}</:string_view></point></p><pre class="brush:php;toolbar:false;">template <typename formatcontext>
auto format(const Point& p, FormatContext& ctx) const -> decltype(ctx.out()) {
    if (/* has 'x' flag */) {
        return std::format_to(ctx.out(), "({:#x},{:#x})", p.x, p.y);
    } else {
        return std::format_to(ctx.out(), "({},{})", p.x, p.y);
    }
}</typename>

};