std::format_to_n
定义于头文件 <format>
|
||
template< class OutputIt, class... Args > std::format_to_n_result<OutputIt> |
(1) | (C++20 起) |
template< class OutputIt, class... Args > std::format_to_n_result<OutputIt> |
(2) | (C++20 起) |
template< class OutputIt, class... Args > std::format_to_n_result<OutputIt> |
(3) | (C++20 起) |
template< class OutputIt, class... Args > std::format_to_n_result<OutputIt> |
(4) | (C++20 起) |
template< class OutputIt > struct format_to_n_result { |
(5) | (C++20 起) |
按照格式字符串 fmt
格式化 args
,并写结果到输出迭代器 out
。至多写 n
个字符。 loc
若存在则用于本地环境特定的格式化。
令 CharT
对重载 (1,3) 为 char
,对重载 wchar_t
为 (2,4) 。
这些重载仅若 OutputIt
满足概念 std::output_iterator<const CharT&> 才参与重载决议。若 OutputIt
不实现(满足其语义要求)概念 std::output_iterator<const CharT&> ,或若对 Args
中任何 Ti
, std::formatter<Ti, CharT> 不满足格式化器 (Formatter) 要求则行为未定义。
std::format_to_n_result
无基类或 out
、 size
及隐式声明的特殊成员函数以外的成员。参数
out | - | 指向输出缓冲区的迭代器 |
n | - | 写入输出缓冲区的最大字符数 |
fmt | - | Args 的合法格式字符串才合法。格式字符串由以下内容组成:
每个替换域拥有下列格式:
arg-id 指定用于格式化其值的 格式说明由对应参数特化的 std::formatter 定义。
|
args... | - | 要格式化的参数 |
loc | - | 用于本地环境特定的格式化的 std::locale |
返回值
format_to_n_result
,其 out
成员为指向输出范围末尾后一位置的迭代器,而 size
成员为总(不截断)的输出大小。
异常
传播格式化器或迭代器操作所抛的任何异常。
示例
#include <format> #include <string_view> #include <iostream> int main() { char buffer[64]; const auto result = std::format_to_n(buffer, std::size(buffer), "Hubble's H{0} {1} {2} miles/sec/mpc.", "\u2080", "\u2245", 42); std::cout << "Buffer: \"" << std::string_view{buffer, result.size} << "\"\n" << "Buffer size = " << std::size(buffer) << '\n' << "Untruncated output size = " << result.size << '\n'; }
输出:
Buffer: "Hubble's H₀ ≅ 42 miles/sec/mpc." Buffer size = 64 Untruncated output size = 35
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
P2216R3 | C++20 | 对非法格式字符串抛出 std::format_error | 非法格式字符串导致编译时错误 |
参阅
(C++20) |
在新 string 中存储参数的格式化表示 (函数模板) |
(C++20) |
通过输出迭代器写其参数的格式化表示 (函数模板) |
(C++20) |
确定存储其参数的格式化表示所需的字符数 (函数模板) |