命名空间
变体
操作

std::println

来自 cppreference.com
< cpp‎ | io
定义在头文件 <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, std::runtime_format(std::string(fmt.get()) + '\n'),
           std::forward<Args>(args)...)
.
3) 等效于 std::println(stdout).
4) 等效于 std::print(stream, "\n").

如果 std::formatter<Ti, char> 对于 Args 中的任何 Ti 都不满足 BasicFormatter 要求(如 std::make_format_args 所需),则行为未定义。

内容

[编辑] 参数

stream - 要写入的输出文件流
fmt - 一个表示格式字符串的对象。格式字符串由以下部分组成
  • 普通字符({} 除外),这些字符会原样复制到输出中,
  • 转义序列 {{}},它们在输出中分别替换为 {},以及
  • 替换字段。

每个替换字段具有以下格式

{ arg-id (可选) } (1)
{ arg-id (可选) : format-spec } (2)
1) 没有格式规范的替换字段
2) 具有格式规范的替换字段
arg-id - 指定 args 中要用于格式化的参数的索引;如果省略,则按顺序使用参数。

格式字符串中的 arg-id  必须全部存在或全部省略。混合手动和自动索引是一个错误。

format-spec - std::formatter 特化针对相应参数定义的格式规范。不能以 } 开头。

(自 C++23 起)
(自 C++26 起)
  • 对于其他可格式化类型,格式规范由用户定义的 formatter 特化决定。
args... - 要格式化的参数

[编辑] 异常

[编辑] 备注

虽然在 C++26 中添加了重载 (3,4),但所有已知的实现都在 C++23 模式下提供它们。

功能测试 Std 功能
__cpp_lib_print 202207L (C++23) 格式化输出
202403L (C++26)
(DR23)
具有流锁定的格式化输出
__cpp_lib_format 202207L (C++23) 公开 std::basic_format_string

[编辑] 示例

#include <print>
 
int main()
{
    // Each call to std::println ends with new-line
    std::println("Please"); // overload (1)
    std::println("enter"); // (1)
 
    std::print("pass");
    std::print("word");
 
    std::println(); // (3); valid since C++26; same effect as std::print("\n"); 
}

输出

Please
enter
password
 

[编辑] 另请参阅

(C++23)
使用参数的 格式化 表示形式,打印到 stdout 或文件流
(函数模板) [编辑]
输出参数的格式化表示,并在末尾追加'\n'
(函数模板) [编辑]
(C++20)
将参数的格式化表示存储在一个新的字符串中
(函数模板) [编辑]
将格式化输出打印到stdout、文件流或缓冲区
(函数) [编辑]