std::vprint_nonunicode, std::vprint_nonunicode_buffered
来自 cppreference.cn
定义于头文件 <print> |
||
void vprint_nonunicode( std::FILE* stream, std::string_view fmt, std::format_args args ); |
(1) | (C++23 起) |
void vprint_nonunicode_buffered ( std::FILE* stream, std::string_view fmt, std::format_args args ); |
(2) | (C++23 起) |
void vprint_nonunicode_buffered ( std::string_view fmt, std::format_args args ); |
(3) | (C++23 起) |
根据格式字符串 fmt 格式化 args,并将结果写入输出流。
1) 在持有 stream 上的锁的同时,将 args 提供的格式化参数的字符表示形式,按照 fmt 中给出的规范格式化后写入 stream。
如果 stream 不是指向输出 C 流的有效指针,则行为未定义。
2) 等价于 std::string out = std::vformat(fmt, args);
std::vprint_nonunicode(stream, "{}", std::make_format_args(out));。
std::vprint_nonunicode(stream, "{}", std::make_format_args(out));。
3) 等价于 std::vprint_nonunicode_buffered(stdout, fmt, args)。
将字符写入输出流后,建立一个 可观察检查点。 |
(C++26 起) |
目录 |
[编辑] 参数
stream | - | 要写入的输出文件流 | ||||||||||||||||||||||||||||||||||||||||||||||
fmt | - |
每个替换字段具有以下格式:
1) 没有格式化规范的替换字段
2) 带有格式化规范的替换字段
| ||||||||||||||||||||||||||||||||||||||||||||||
args | - | 要格式化的参数 |
[编辑] 异常
- 分配失败时抛出 std::bad_alloc。
- 如果写入流失败,抛出 std::system_error。
- 传播使用的 格式化器 抛出的任何异常,例如 std::format_error。
[编辑] 注意
特性测试宏 | 值 | 标准 | 特性 |
---|---|---|---|
__cpp_lib_print |
202207L |
(C++23) | 格式化输出 |
202403L |
(C++26) (DR23) |
无缓冲格式化输出 | |
202406L |
(C++26) (DR23) |
为更多可格式化类型启用无缓冲格式化输出 | |
__cpp_lib_format |
202207L |
(C++23) | 公开 std::basic_format_string |
[编辑] 示例
本节不完整 原因:无示例 |
[编辑] 缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
---|---|---|---|
P3107R5 | C++23 | 打印操作总是带缓冲的 | 提供无缓冲的打印操作 |
P3235R3 | C++23 | 添加的函数名称 P3107R5 具有误导性 |
更改了函数名称 |
[编辑] 另请参阅
使用 类型擦除的 参数表示,打印到支持 Unicode 的 stdout 或文件流 (函数) | |
使用类型擦除的参数表示输出字符数据 (函数) | |
(C++23) |
使用参数的格式化表示打印到 stdout 或文件流 (函数模板) |
(C++20) |
将参数的格式化表示存储在新字符串中 (函数模板) |