std:: println (std::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 流中。

如果对于 Args 中的任意 Ti ， std:: formatter < Ti, char > 不满足 BasicFormatter 要求（根据 std:: make_format_args 的要求），则行为未定义。

目录 1 参数 2 异常 3 备注 4 示例 5 缺陷报告 6 参阅

参数

os	-	用于插入数据的输出流
fmt	-	表示格式字符串的对象。格式字符串包含： 普通字符（除了 { 和 } ），它们会原样复制到输出中， 转义序列 { { 和 } } ，它们在输出中分别被替换为 { 和 } ，以及 替换字段。 每个替换字段具有以下格式： { arg-id (optional) } (1) { arg-id (optional) : format-spec } (2) 1) 不带格式说明的替换字段 2) 带格式说明的替换字段 arg-id - 指定 args 中参数的索引，其值将用于格式化；如果省略，则按顺序使用参数。 格式字符串中的 arg-id 必须全部存在或全部省略。混合手动和自动索引是错误的。 format-spec - 由对应参数的 std::formatter 特化定义的格式规范。不能以 } 开头。 对于基本类型和标准字符串类型，格式规范被解释为 标准格式规范 。 对于 chrono 类型，格式规范被解释为 chrono 格式规范 。 对于范围类型，格式规范被解释为 范围格式规范 。 对于 std::pair 和 std::tuple ，格式规范被解释为 元组格式规范 。 对于 std::thread::id 和 std::stacktrace_entry ，请参阅 线程 ID 格式规范 和 堆栈跟踪条目格式规范 。 对于 std::basic_stacktrace ，不允许使用格式说明符。 (since C++23) 对于 std::filesystem::path ，请参阅 路径格式规范 。 (since C++26) 对于其他可格式化类型，格式规范由用户定义的 formatter 特化决定。
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++标准。

DR	适用范围	发布时的行为	正确行为
LWG 4088	C++23	( 1 ) 在格式化参数时忽略了 os 中设置的区域设置	应使用该区域设置

参见

print (std::ostream) (C++23)	输出参数的 格式化 表示 (函数模板)
println (C++23)	与 std::print 相同，但每次输出后附加换行符 (函数模板)
format (C++20)	将参数的格式化表示存储到新字符串中 (函数模板)