std::println(std::ostream)

来自cppreference.com

在标头 `<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 的要求），则其行为未定义。

实参索引	-	指定用于格式化它的值的 `args` 中的参数的下标；如果省略实参索引，那么按顺序使用参数。格式字符串中的实参索引必须全部存在或全部被省略。混合手动和自动指定下标是错误。
格式说明	-	格式说明由对应参数特化的 std::formatter 定义。不能以 } 开始。

(C++23 起)

(C++26 起)

args... - 要格式化的实参

内存分配失败时抛出 std::bad_alloc。
传播由其所使用的格式化器所抛出的任何异常，比如 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 浸染的本地环境	使用该本地环境

print(std::ostream) (C++23)	输出各实参的格式化表示 (函数模板) [编辑]
println (C++23)	将参数的格式化表达输出到 stdout 或文件缓冲区，输出完成后换行 (函数模板) [编辑]
format (C++20)	在新字符串中存储参数的格式化表示 (函数模板) [编辑]

目录