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 的输出迭代器。
成员类型
类型 | 定义 |
iterator
|
OutputIt
|
char_type
|
CharT
|
成员别名模版
类型 | 定义 |
formatter_type<T>
|
std::formatter<T, CharT> |
成员函数
arg |
返回位于给定下标的参数 (公开成员函数) |
locale |
返回用于本地环境特定格式化的本地环境 (公开成员函数) |
out |
返回指向输出缓冲区的迭代器 (公开成员函数) |
advance_to |
推进输出迭代器到给定位置 (公开成员函数) |
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::basic_format_context::locale
std::locale locale(); |
||
返回传递给格式化函数的本地环境,或若格式化函数不接收本地环境返回默认构造的 std::locale 。
std::basic_format_context::out
iterator out(); |
||
返回指向输出缓冲区的迭代器。
std::basic_format_context::advance_to
void advance_to(iterator it); |
||
设置输出迭代器为 it
。调用 advance_to
后,对 out()
的后继调用将返回 it
的副本。
示例
本节未完成 原因:暂无示例 |