std::vprint_nonunicode, std::vprint_nonunicode_buffered
来自cppreference.com
在标头 <print> 定义
|
||
void vprint_nonunicode( std::FILE* stream, std::string_view fmt, std::format_args args ); |
(2) | (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)。
参数
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 |
示例
本节未完成 原因:暂无示例 |
参阅
使用类型擦除的参数表示,打印到支持Unicode的 stdout 或文件流 (函数) | |
使用类型擦除输出各实参的格式化表示 (函数) | |
(C++23) |
将参数的格式化表达输出到 stdout 或文件缓冲区 (函数模板) |
(C++20) |
在新字符串中存储参数的格式化表示 (函数模板) |