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 起)

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

std::basic_format_args::basic_format_args

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++ 标准。

缺陷报告	应用于	发布时的行为	正确的行为
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)

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