std::vprint_nonunicode, std::vprint_nonunicode_buffered

来自cppreference.com
< cpp‎ | io
在标头 <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));
3) 等价于:std::vprint_nonunicode_buffered(stdout, fmt, args)

参数

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

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

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

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

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

(C++23 起)
(C++26 起)
  • 对于其他可格式化类型,格式说明由用户定义的 std::formatter 特化决定。
args - 要格式化的实参

异常

注解

功能特性测试 标准 功能特性
__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)
在新字符串中存储参数的格式化表示
(函数模板)