std:: vprint_nonunicode (std::ostream)

定义于头文件 <ostream>
void vprint_nonunicode ( std:: ostream & os, std:: string_view fmt, std:: format_args args ) ;		(C++23 起)

表现为 格式化输出函数 （除了错误报告的某些细节 有所不同 ）。

按顺序执行以下操作：

1. 首先，构造并检查 sentry 对象。
2. 然后，初始化自动变量，如同执行 std:: string out = std:: vformat ( os. getloc ( ) , fmt, args ) ; 。
3. 最后，将字符序列 [ out. begin ( ) , out. end ( ) ) 插入到 os 中。

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

(since C++26)

目录 1 参数 2 异常 3 备注 4 示例 5 参见

参数

os	-	用于插入数据的输出流
fmt	-	表示格式字符串的对象。格式字符串包含： 普通字符（除了 { 和 } ），它们会原样复制到输出中， 转义序列 { { 和 } } ，它们在输出中分别被替换为 { 和 } ，以及 替换字段。 每个替换字段具有以下格式： { arg-id (optional) } (1) { arg-id (optional) : format-spec } (2) 1) 不带格式说明的替换字段 2) 带格式说明的替换字段 arg-id - 指定 args 中参数的索引，其值将用于格式化；如果省略，则按顺序使用参数。 格式字符串中的 arg-id 必须全部存在或全部省略。混合手动和自动索引是错误的。 format-spec - 由对应参数的 std::formatter 特化定义的格式规范。不能以 } 开头。 对于基本类型和标准字符串类型，格式规范被解释为 标准格式规范 。 对于 chrono 类型，格式规范被解释为 chrono 格式规范 。 对于范围类型，格式规范被解释为 范围格式规范 。 对于 std::pair 和 std::tuple ，格式规范被解释为 元组格式规范 。 对于 std::thread::id 和 std::stacktrace_entry ，请参阅 线程 ID 格式规范 和 堆栈跟踪条目格式规范 。 对于 std::basic_stacktrace ，不允许使用格式说明符。 (since C++23) 对于 std::filesystem::path ，请参阅 路径格式规范 。 (since C++26) 对于其他可格式化类型，格式规范由用户定义的 formatter 特化决定。
args	-	要格式化的参数

异常

• 分配失败时抛出 std::bad_alloc 。
• 传播任何由 formatter 抛出的异常（例如 std::format_error ），不考虑 os. exceptions ( ) 的值，且不会在 os 的错误状态中设置 ios_base::badbit 。
• 可能抛出由 os. setstate ( ios_base :: badbit ) 引发的 ios_base::failure ，该调用在向 os 插入数据失败时执行。

注释

功能测试 宏	值	标准	功能
__cpp_lib_print	202207L	(C++23)	格式化输出
__cpp_lib_format	202207L	(C++23)	暴露 std::basic_format_string

示例

本节内容不完整 原因：缺少示例

参见

vprint_unicode (std::ostream) (C++23)	使用 类型擦除 参数表示执行Unicode感知输出 (函数)
print (std::ostream) (C++23)	输出参数的 格式化 表示 (函数模板)
operator<< (std::basic_ostream)	插入字符数据或插入到右值流 (函数模板)
vprint_nonunicode vprint_nonunicode_buffered (C++23)	使用 类型擦除 参数表示打印到 stdout 或文件流 (函数)
format (C++20)	将参数的格式化表示存储到新字符串中 (函数模板)