std::println(std::ostream) - cppreference.com

来自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...));

如果 Args 中有任何 Ti，使得 std::formatter<Ti, char> 不满足基本格式化器 (BasicFormatter) 的要求（如 std::make_format_args 的要求），则其行为未定义。

os - 要插入数据的输出流

fmt

用于表示格式字符串的对象。格式字符串由以下组成

每个替换域拥有如下格式：

1) 没有格式说明的替换域

2) 有格式说明的替换域

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

对于范围类型，格式说明为范围格式说明。
对于 std::pair 和 std::tuple，格式说明为 tuple 格式说明。
对于 std::thread::id 和 std::stacktrace_entry，见 thread id 格式说明和 stacktrace entry 格式说明。
对于 std::basic_stacktrace，不允许使用格式说明符。

(C++23 起)

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

内存分配失败时抛出 std::bad_alloc。
传播由其所使用的格式化器所抛出的任何异常，比如 std::format_error，不管 os.exceptions() 的值如何，也不会在 os 的错误状态中打开 std::ios_base::badbit。
向 os 的插入失败时，可能会抛出由 os.setstate(ios_base::badbit) 调用所造成的 std::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` 浸染的本地环境	使用该本地环境