std::println(std::ostream)
来自cppreference.com
< 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(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。
- 传播由其所使用的格式化器所抛出的任何异常,比如 std::format_error,不管 os.exceptions() 的值如何,也不会在 os 的错误状态中打开 ios_base::badbit。
- 可能会抛出由 os.setstate(ios_base::badbit) 所造成的ios_base::failure,它是当向 os 的插入失败时调用的。
注解
虽然重载 (2) 是在 C++26 中添加的,所有已知实现都使得它在 C++23 模式中可用。
功能特性测试宏 | 值 | 标准 | 功能特性 |
---|---|---|---|
__cpp_lib_print |
202207L | (C++23) | 格式化输出 |
__cpp_lib_format |
202207L | (C++23) | 暴露 std::basic_format_string |
示例
本节未完成 原因:暂无示例 |
参阅
(C++23) |
输出各实参的格式化表示 (函数模板) |
(C++23) |
将参数的格式化表达输出到 stdout 或文件缓冲区,输出完成后换行 (函数模板) |
(C++20) |
在新字符串中存储参数的格式化表示 (函数模板) |