std::basic_format_context

在标头 `<format>` 定义
template<class OutputIt, class CharT> class basic_format_context;	(1)	(C++20 起)
using format_context = basic_format_context</* unspecified */, char>;	(2)	(C++20 起)
using wformat_context = basic_format_context</* unspecified */, wchar_t>;	(3)	(C++20 起)

提供到由格式化参数和输出迭代器组成的格式化状态的访问。

若 OutputIt 不实现 std::output_iterator<const CharT&> 则行为未定义。

2) 未指明的模板实参是后附到 std::string 的输出迭代器，例如 std::back_insert_iterator<std::string> 。鼓励实现使用到支持后附到任何连续存储且大小可变的容器的类型擦除缓冲。

3) 未指明的模板实参是后附到 std::wstring 的输出迭代器。

类型	定义
`formatter_type<T>`	std::formatter<T, CharT>

std::basic_format_context::arg

std::basic_format_arg<basic_format_context> arg(std::size_t id) const;

返回保有 args 中第 id 元素的 std::basic_format_arg ，其中 args 是参数包或传递给格式化函数的 std::basic_format_args 对象。

若 id 不小于格式化参数的数量，则返回默认构造的 std::basic_format_arg （保有一个 std::monostate 对象）。

std::locale locale();

返回传递给格式化函数的本地环境，或若格式化函数不接收本地环境返回默认构造的 std::locale 。

iterator out();

返回指向输出缓冲区的迭代器。从存储的迭代器移动构造结果。

void advance_to(iterator it);

移动赋值 it 给存储的输出迭代器。调用 advance_to 后，对 out() 的后继调用将返回 it 的副本。

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

缺陷报告	应用于	出版时的行为	正确行为
LWG 3567	C++20	`basic_format_context` 无法用于仅移动的迭代器类型	使之移动迭代器

格式化函数
format (C++20)
format_to (C++20)
format_to_n (C++20)
formatted_size (C++20)
vformat (C++20)
vformat_to (C++20)
格式化概念
formattable (C++23)
格式化器
formatter (C++20)
range_formatter (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)
basic_format_stringformat_stringwformat_string (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)