std::basic_format_args

定义于头文件 `<format>`
template< class Context > class basic_format_args;	(1)	(自 C++20 起)
using format_args = basic_format_args<std::format_context>;	(2)	(自 C++20 起)
using wformat_args = basic_format_args<std::wformat_context>;	(3)	(自 C++20 起)

提供对格式化参数的访问。

内容

(构造函数)	构造一个 `basic_format_args` 对象 (公有成员函数)
get	返回给定索引处的格式化参数 (公有成员函数)

template< class... Args > basic_format_args( const /format-arg-store/<Context, Args...>& store ) noexcept;

从调用 std::make_format_args 或 std::make_wformat_args 的结果构造一个 basic_format_args 对象。

std::basic_format_arg<Context> get( std::size_t i ) const noexcept;

返回一个 std::basic_format_arg，其中持有 args 中的第 i 个参数，其中 args 是传递给 std::make_format_args 或 std::make_wformat_args 的参数包。

如果没有这样的格式化参数（即 *this 是默认构造的，或者 i 不小于格式化参数的数量），则返回一个默认构造的 std::basic_format_arg（持有 std::monostate 对象）。

template< class Context, class... Args > basic_format_args( /format-arg-store/<Context, Args...> ) -> basic_format_args<Context>;		(自 C++20 起)

std::basic_format_args 具有引用语义。程序员有责任确保 *this 不会比 store 活得更久（而 store 反过来不应比 std::make_format_args 或 std::make_wformat_args 的参数活得更久）。

以下行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

DR	应用于	已发布行为	正确行为
P2216R3	C++20	由于 `vformat_to` 的过度参数化，提供了 `format_args_t`	已移除
LWG 3810	C++20	`basic_format_args` 没有推导指引	已添加
LWG 4106	C++20	`basic_format_args` 是默认可构造的	默认构造函数已移除

(C++20)

为用户定义的格式化器提供对格式化参数访问的类模板
(类模板) [编辑]

标准格式规范
格式化函数
format (C++20)
format_to (C++20)
format_to_n (C++20)
formatted_size (C++20)
vformat (C++20)
vformat_to (C++20)
格式字符串
basic_format_stringformat_stringwformat_string (C++20)(C++20)(C++20)
runtime_format (C++26)
格式化概念
formattable (C++23)
Formatter
formatter (C++20)
formatter<pair-or-tuple> (C++23)
formatter<range> (C++23)
range_formatter (C++23)
enable_nonlocking_formatter_optimization (C++23)
basic_format_parse_contextformat_parse_contextwformat_parse_context (C++20)(C++20)(C++20)
basic_format_contextformat_contextwformat_context (C++20)(C++20)(C++20)
range_format (C++23)
format_kind (C++23)
格式化参数
basic_format_arg (C++20)
basic_format_arg::handle (C++20)
basic_format_argsformat_argswformat_args (C++20)(C++20)(C++20)
visit_format_arg (C++20) (在 C++26 中弃用)
make_format_argsmake_wformat_args (C++20)(C++20)
格式错误
format_error (C++20)