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 的输出迭代器。

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 的副本。

格式化函数
format (C++20)
format_to (C++20)
format_to_n (C++20)
formatted_size (C++20)
vformat (C++20)
vformat_to (C++20)
格式化器
formatter (C++20)
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)
格式化参数
basic_format_arg (C++20)
basic_format_argsformat_argswformat_argsformat_args_t (C++20)(C++20)(C++20)(C++20)
visit_format_arg (C++20)
make_format_argsmake_wformat_args (C++20)(C++20)
格式错误
format_error (C++20)