命名空间
变体
操作

格式化库 (C++20 起)

来自 cppreference.cn
< cpp‎ | 工具
 
C++
 
文本处理库
 
格式化库
标准格式规范
格式化函数
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
格式字符串
(C++20)(C++20)(C++20)
(C++26)
格式化概念
(C++23)
Formatter
(C++20)
(C++23)
(C++23)
(C++23)
(C++23)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
(C++23)
(C++23)
格式化参数
(C++20)
(C++20)
(C++20)(C++20)(C++20)
(C++20) (在 C++26 中废弃)
(C++20)(C++20)
格式错误
(C++20)
 

文本格式化库提供了一种安全且可扩展的替代方案，以取代 printf 系列函数。它旨在补充现有的 C++ I/O 流库。

目录

[编辑] 格式规范

格式规范指定了对象如何以不同类型的选项进行格式化。

基本类型和标准字符串类型的对象格式化使用基本格式规范。其他库组件也可能提供自己的格式规范，详见此处。

[编辑] 格式化函数

定义于头文件 <format>
(C++20)
 将参数的格式化表示存储在新字符串中
(函数模板) [编辑]
(C++20)
 通过输出迭代器写出其参数的格式化表示
(函数模板) [编辑]
(C++20)
 通过输出迭代器写出其参数的格式化表示，不超过指定大小
(函数模板) [编辑]
(C++20)
 确定存储其参数格式化表示所需的字符数
(函数模板) [编辑]

[编辑] 格式字符串

定义于头文件 <format>
(C++20)(C++20)(C++20)
 在构造时执行编译时格式字符串检查的类模板
(类模板) [编辑]
(C++26)
 创建可直接用于面向用户的格式化函数的运行时格式字符串
(函数) [编辑]

[编辑] 格式化概念

定义于头文件 <format>
(C++23)
 指定一个类型是可格式化的，即它专门化了 std::formatter 并提供了成员函数 parse 和 format
(概念) [编辑]

[编辑] 可扩展性支持和实现细节

定义于头文件 <format>
(C++20)
 使用类型擦除参数表示的 std::format 的非模板变体
(函数) [编辑]
(C++20)
 使用类型擦除参数表示的 std::format_to 的非模板变体
(函数模板) [编辑]
(C++20)(C++20)
 创建引用所有格式化参数的类型擦除对象，可转换为 format_args
(函数模板) [编辑]
(C++20) (在 C++26 中废弃)
 用户定义格式化器的参数访问接口
(函数模板) [编辑]
(C++20)
 定义给定类型的格式化规则
(类模板) [编辑]
(C++23)
 有助于实现范围类型的 std::formatter 特化的类模板
(类模板) [编辑]
(C++23)
 指示参数类型可以高效打印
(变量模板)[编辑]
(C++23)
 指定范围应如何格式化
(枚举) [编辑]
(C++23)
 为范围选择合适的 std::range_format
(变量模板)[编辑]
(C++20)
 为用户定义格式化器提供格式化参数访问的类模板
(类模板) [编辑]
(C++20)(C++20)(C++20)
 提供对所有格式化参数访问的类
(类模板) [编辑]
(C++20)(C++20)(C++20)
 格式化状态，包括所有格式化参数和输出迭代器
(类模板) [编辑]
(C++20)(C++20)(C++20)
 格式化字符串解析器状态
(类模板) [编辑]
(C++20)
 格式化错误时抛出的异常类型
(类) [编辑]

[编辑] 辅助项 (C++23 起)

template< class R, class CharT >

concept /*const-formattable-range*/ =
    ranges::input_range<const R> &&

    std::formattable<ranges::range_reference_t<const R>, CharT>;
 (1) (仅作说明*)
template< class R, class CharT >

using /*fmt-maybe-const*/ =

    std::conditional_t</*const-formattable-range*/<R, CharT>, const R, R>;
 (2) (仅作说明*)

[编辑] 注意

特性测试宏 值 标准 特性
__cpp_lib_format 201907L (C++20) 文本格式化
202106L (C++23)
(DR20)		 编译时格式字符串检查；
减少 std::vformat_to 的参数化
202110L (C++23)
(DR20)		 修复 chrono 格式化器中的区域设置处理；
支持不可 const-formattable 的类型
202207L (C++23)
(DR20)		 公开 std::basic_format_string；
澄清 chrono 类型本地化格式化中编码的处理
202304L (C++26) 指针格式化
202305L (C++26) 类型检查格式参数
202306L (C++26) 成员 std::basic_format_arg::visit
202311L (C++26) 运行时格式字符串
202403L (C++26) 使用 std::println 打印空行
202403L (C++26)
(DR23)		 允许 std::print 的高效实现
本节不完整
原因：该值应 >= 202406L，即与前一个不同
__cpp_lib_format_ranges 202207L (C++23) 格式化范围
__cpp_lib_format_path 202403L (C++26) 格式化 std::filesystem::path
__cpp_lib_format_uchar 202311L (C++26) 修复代码单元作为整数的格式化
__cpp_lib_formatters 202302L (C++23) 格式化 std::thread::id 和 std::stacktrace

我们有意将 std::basic_format_string (P2508) 的添加视为缺陷报告，因为所有已知实现都在 C++20 模式下提供这些组件，尽管它并未正式归类。

[编辑] 示例

运行此代码
#include <cassert>
#include <format>
 
int main()
{
    std::string message = std::format("The answer is {}.", 42);
    assert(message == "The answer is 42.");
}

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 发布时的行为 正确的行为
P2418R2 C++20 既不可 const-formattable 也不可复制的对象
(例如生成器类对象) 不可格式化		 允许格式化这些对象
(放宽格式化器要求)
P2508R1 C++20 该功能没有用户可见的名称 公开了名称 basic_format_string

[编辑] 另请参见

(C++23)
 使用参数的格式化表示打印到 stdout 或文件流
(函数模板) [编辑]
(C++23)
 与 std::print 相同，但每次打印都以额外的换行符终止
(函数模板) [编辑]
(C++23)
 输出参数的格式化表示
(函数模板) [编辑]
取自“https://cppreference.cn/mwiki/index.php?title=cpp/utility/format&oldid=179594”