命名空间
变体
操作

std::vprint_nonunicode, std::vprint_nonunicode_buffered

来自 cppreference.cn
< cpp‎ | io
定义于头文件 <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));
3) 等价于 std::vprint_nonunicode_buffered(stdout, fmt, args)


将字符写入输出流后,建立一个 可观察检查点

(C++26 起)

目录

[编辑] 参数

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 - 要格式化的参数

[编辑] 异常

[编辑] 注意

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