Namespaces
Variants

std:: vprint_nonunicode, std:: vprint_nonunicode_buffered

From cppreference.net
< cpp ‎ | io
C++
Input/output library
Print functions
Print functions
(C++23)
(C++23)
(C++23) (C++23)
vprint_nonunicode vprint_nonunicode_buffered
(C++23) (C++23)
定义于头文件 <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 ) 。


向输出流写入字符后，建立一个 可观测检查点 。

(since C++26)

目录

参数

stream - 用于写入的输出文件流
fmt -
表示格式字符串的对象。格式字符串包含：
  • 普通字符（除了 { 和 } ），它们会原样复制到输出中，
  • 转义序列 { { 和 } } ，它们在输出中分别被替换为 { 和 } ，以及
  • 替换字段。

每个替换字段具有以下格式：

{ arg-id (optional) } (1)
{ arg-id (optional) : format-spec } (2)
1) 不带格式说明的替换字段
2) 带格式说明的替换字段
arg-id - 指定 args 中参数的索引，其值将用于格式化；如果省略，则按顺序使用参数。

格式字符串中的 arg-id 必须全部存在或全部省略。混合手动和自动索引是错误的。

format-spec - 由对应参数的 std::formatter 特化定义的格式规范。不能以 } 开头。

(since C++23)
(since 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
添加的函数名称存在误导性 		修改了函数名称

参见

(C++23)
使用 类型擦除 参数表示形式向支持Unicode的 stdout 或文件流打印输出
(函数)
(C++23)
使用 类型擦除 参数表示形式输出字符数据
(函数)
(C++23)
使用参数的 格式化 表示形式向 stdout 或文件流打印输出
(函数模板)
(C++20)
将参数的格式化表示形式存储到新字符串中
(函数模板)