std::println

来自cppreference.com
< cpp‎ | io
 
C++
 
输入/输出库
 
打印函数
打印函数
(C++23)
println
(C++23)
(C++23)(C++23)
(C++23)(C++23)
 
在标头 <print> 定义
template< class... Args >
void println( std::format_string<Args...> fmt, Args&&... args );
 (1) (C++23 起)
template< class... Args >

void println( std::FILE* stream,

              std::format_string<Args...> fmt, Args&&... args );
 (2) (C++23 起)
void println();
 (3) (C++26 起)
void println( std::FILE* stream );
 (4) (C++26 起)

根据格式字符串 fmt 格式化 args 并追加 '\n'（这意味着每次输出均以换行符结尾），并将结果打印到流中。

1) 等价于 std::println(stdout, fmt, std::forward<Args>(args)...)。
2) 等价于进行以下操作：

std::print(stream, "{}\n", std::format(fmt, std::forward<Args>(args)...));

(C++26 前)

std::print(stream, std::runtime_format(std::string(fmt.get()) + '\n'),
           std::forward<Args>(args)...)

(C++26 起)
3) 等价于 std::println(stdout)。
4) 等价于 std::print(stream, "\n")。

如果 Args 中存在任何 Ti 导致 std::formatter<Ti, char> 不满足基本格式化器 (BasicFormatter) 的要求（如 std::make_format_args 所要求），那么行为未定义。

目录

[编辑] 参数

stream - 要写入的输出文件流
fmt -
[编辑]
用于表示格式字符串的对象。格式字符串由以下组成
  • 通常字符（除了 { 与 }），它们被不加修改地复制到输出，
  • 转义序列 {{ 与 }} ，它们在输出中被分别替换成 { 与 } ，以及
  • 替换域。

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

{ 实参索引 (可选) } (1)
{ 实参索引 (可选) : 格式说明 } (2)
1) 没有格式说明的替换域
2) 有格式说明的替换域
实参索引 - 指定用于格式化它的值的 args 中的参数的下标；如果省略实参索引，那么按顺序使用参数。

格式字符串中的实参索引 必须全部存在或全部被省略。混合手动和自动指定下标是错误。

格式说明 - 格式说明由对应参数特化的 std::formatter 定义。不能以 } 开始。