std::println(std::ostream)
来自 cppreference.cn
< cpp | io | basic ostream
定义于头文件 <ostream> |
||
template< class... Args > void println( std::ostream& os, std::format_string<Args...> fmt, Args&&... args ); |
(1) | (C++23 起) |
void println( std::ostream& os ); |
(2) | (C++26 起) |
根据格式字符串 `fmt` 格式化 `args`,并附加 '\n'(这意味着每个输出都以换行符结尾),然后将结果插入到 os 流中。
1) 等价于:std::print(os, "{}\n", std::format(os.getloc(), fmt, args...));
2) 等价于:std::print(os, "\n");
如果对于 `Args` 中的任何 `Ti`,std::formatter<Ti, char> 不符合 BasicFormatter 要求(如 std::make_format_args 所要求),则行为是未定义的。
目录 |
[编辑] 参数
os | - | 要插入数据的输出流 | ||||||||||||||||||||||||||||||||||||||||||||||
fmt | - |
每个替换字段具有以下格式:
1) 没有格式化规范的替换字段
2) 带有格式化规范的替换字段
| ||||||||||||||||||||||||||||||||||||||||||||||
args... | - | 要格式化的参数 |
[编辑] 异常
- 分配失败时抛出 std::bad_alloc。
- 传播任何由 formatter 抛出的异常,例如 std::format_error,而无论 os.exceptions() 的值如何,并且不在 os 的错误状态中开启 ios_base::badbit。
- 如果插入到 os 失败,可能会抛出由 os.setstate(ios_base::badbit) 引起的 ios_base::failure。
[编辑] 注意
尽管重载 (2) 在 C++26 中添加,但所有已知实现都使其在 C++23 模式下可用。
特性测试宏 | 值 | 标准 | 特性 |
---|---|---|---|
__cpp_lib_print |
202207L |
(C++23) | 格式化输出 |
__cpp_lib_format |
202207L |
(C++23) | 公开 std::basic_format_string |
[编辑] 示例
本节不完整 原因:无示例 |
[编辑] 缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
---|---|---|---|
LWG 4088 | C++23 | (1) 格式化参数时忽略了 os 中嵌入的区域设置 | 使用了该区域设置 |
[编辑] 另请参阅
(C++23) |
输出参数的格式化表示 (函数模板) |
(C++23) |
与 std::print 相同,但每次打印都以额外的换行符终止 (函数模板) |
(C++20) |
将参数的格式化表示存储在新字符串中 (函数模板) |