std::println
来自 cppreference.com
定义在头文件 <print> 中 |
||
template< class... Args > void println( std::format_string<Args...> fmt, Args&&... args ); |
(1) | (自 C++23 起) |
template< class... Args > void println( std::FILE* stream, |
(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)...).
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 | - |
每个替换字段具有以下格式
1) 没有格式规范的替换字段
2) 具有格式规范的替换字段
| ||||||||||||||||||||||||||||||||||||||||||||||
args... | - | 要格式化的参数 |
[编辑] 异常
- 分配失败时 std::bad_alloc。
- 如果写入流失败,则 std::system_error。
- 传播由所使用的 格式化程序 抛出的任何异常,例如 std::format_error。
[编辑] 备注
虽然在 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 或文件流 (函数模板) |
(C++23) |
输出参数的格式化表示,并在末尾追加'\n' (函数模板) |
(C++20) |
将参数的格式化表示存储在一个新的字符串中 (函数模板) |
(C++11) |
将格式化输出打印到stdout、文件流或缓冲区 (函数) |