std::vwprintf, std::vfwprintf, std::vswprintf
定义在头文件 <cwchar> 中 |
||
int vwprintf( const wchar_t* format, va_list vlist ); |
(1) | |
int vfwprintf( std::FILE* stream, const wchar_t* format, va_list vlist ); |
(2) | |
int vswprintf( wchar_t* buffer, std::size_t buf_size, const wchar_t* format, va_list vlist ); |
(3) | |
从 vlist
定义的位置加载数据,将它们转换为宽字符串等效项,并将结果写入各种接收器。
stream
。buffer
。最多写入 size-1 个宽字符,然后是空宽字符。内容 |
[编辑] 参数
stream | - | 要写入的输出宽流 |
buffer | - | 指向要写入的宽字符串的指针 |
buf_size | - | 要写入的宽字符的最大数量 |
format | - | 指向以 null 结尾的宽字符串的指针,指定如何解释数据 |
vlist | - | 可变参数列表,包含要打印的数据。 |
格式字符串由普通宽字符(%
除外)组成,这些字符将不变地复制到输出流中,以及转换规范。每个转换规范具有以下格式
- 介绍性
%
字符。
- 介绍性
- (可选) 一个或多个修饰转换行为的标志
-
-
: 转换的结果在字段中左对齐(默认情况下,它是右对齐的)。 -
+
: 有符号转换的符号始终在转换结果之前附加(默认情况下,结果仅在为负时才以减号开头)。 - 空格: 如果有符号转换的结果不以符号字符开头,或者为空,则会在结果前附加空格。如果存在
+
标志,则会忽略它。 -
#
: 执行转换的替代形式。有关确切效果,请参见下表,否则行为未定义。 -
0
: 对于整数和浮点数转换,使用前导零而不是空格字符来填充字段。对于整数,如果显式指定了精度,则会忽略它。对于使用此标志的其他转换,会导致未定义的行为。如果存在-
标志,则会忽略它。
-
- (可选) 指定最小字段宽度的整数或
*
。如果需要,结果将使用空格字符(默认情况下)在右对齐时在左侧填充,或者在左对齐时在右侧填充。当使用*
时,宽度由类型为 int 的附加参数指定,该参数出现在要转换的参数之前,以及提供精度的参数(如果存在)。如果参数的值为负数,则会指定-
标志和正字段宽度(注意:这是最小宽度:该值永远不会被截断)。
- (可选) 指定最小字段宽度的整数或
- (可选)
.
后跟整数或*
,或者两者都不存在,用于指定转换的精度。当使用*
时,精度由类型为 int 的附加参数指定,该参数出现在要转换的参数之前,但在提供最小字段宽度的参数之后(如果存在)。如果此参数的值为负数,则会忽略它。如果没有使用数字或*
,则精度将取为零。有关精度的确切效果,请参见下表。
- (可选)
- (可选) 长度修饰符,用于指定参数的大小(与转换格式说明符结合使用,它指定相应参数的类型)。
- 转换格式说明符。
以下格式说明符可用
转换 说明符 |
解释 | 预期 参数类型 | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
长度 →
修饰符 |
hh
(C++11) |
h
|
(无) | l
|
ll
(C++11) |
j
(C++11) |
z
(C++11) |
t
(C++11) |
L
| |
%
|
写入文字 % 。完整的转换规范必须为 %% 。 |
N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A |
c
|
该参数首先转换为 wchar_t,就像通过调用 btowc 一样。如果使用了l 修饰符,则 |
N/A | N/A | int |
wint_t |
N/A | N/A | N/A | N/A | N/A |
s
|
该参数必须是指向包含多字节字符序列(从初始移位状态开始)的字符数组的初始元素的指针,该字符序列将转换为宽字符数组,就像通过调用 mbrtowc 使用零初始化的转换状态一样。精度指定要写入的宽字符的最大数量。如果未指定精度,则写入直至但不包括第一个空终止符的所有宽字符。如果使用了l 说明符,则该参数必须是指向 wchar_t 数组的初始元素的指针。 |
N/A | N/A | char* |
wchar_t* |
N/A | N/A | N/A | N/A | N/A |
d i
|
精度指定要显示的最小位数。默认精度为 1。 |
signed char |
短 |
int |
长 |
长 长 |
intmax_t |
带符号 size_t |
ptrdiff_t |
N/A |
o
|
精度指定要显示的最小位数。默认精度为 1。如果转换后的值和精度都为 0,则转换结果不包含任何字符。在备用实现中,如果需要,精度会增加以写入一个前导零。在这种情况下,如果转换后的值和精度都为 0,则会写入单个 0。 |
无符号 字符 |
无符号 短 |
无符号 整数 |
无符号 长 |
无符号 长 长 |
uintmax_t |
size_t |
ptrdiff_t 的无符号版本 |
N/A |
x X
|
对于 |
N/A | ||||||||
u
|
精度指定要显示的最小位数。默认精度为 1。如果转换后的值和精度都为 0,则转换结果不包含任何字符。 |
N/A | ||||||||
f F
|
精度指定小数点后要显示的精确位数。默认精度为 6。在备用实现中,即使没有后续数字,也会写入小数点字符。有关无穷大和非数字的转换样式,请参见注释。 |
N/A | N/A | 双精度 |
双精度(C++11) |
N/A | N/A | N/A | N/A | 长 双精度 |
e E
|
对于 |
N/A | N/A | N/A | N/A | N/A | N/A | |||
a A
(C++11) |
对于 |
N/A | N/A | N/A | N/A | N/A | N/A | |||
g G
|
对于
除非请求备用表示形式,否则尾随零将被删除,并且如果剩余部分为小数部分,则小数点字符也将被删除。有关无穷大和非数字的转换样式,请参见注释。 |
N/A | N/A | N/A | N/A | N/A | N/A | |||
n
|
结果写入到参数指向的值。规范可能不包含任何标志、字段宽度或精度。 |
带符号 字符* |
短* |
整数* |
长* |
长 长* |
intmax_t* |
带符号 size_t* |
ptrdiff_t* |
N/A |
p
|
写入定义指针的实现定义的字符序列。 | N/A | N/A | 空* | N/A | N/A | N/A | N/A | N/A | N/A |
浮点转换函数将无穷大转换为inf
或 infinity
。使用哪一个由实现定义。
非数字将转换为nan
或 nan(char_sequence)
。使用哪一个由实现定义。
转换F
、E
、G
、A
输出INF
、INFINITY
、NAN
。
即使%c
需要int
参数,但由于在调用可变参数函数时会进行整数提升,因此传递char
是安全的。
固定宽度字符类型(int8_t 等)的正确转换规范在头文件 <cinttypes> 中定义(尽管 PRIdMAX、PRIuMAX 等与%jd
、%ju
等同义)。
内存写入转换说明符 %n 是安全漏洞的常见目标,其中格式字符串依赖于用户输入,并且不受边界检查的printf_s
函数族支持。
每个转换说明符操作之后都有一个顺序点;这允许将多个 %n 结果存储在同一个变量中,或者作为边缘情况,在同一个调用中打印由早期 %n 修改的字符串。
如果转换规范无效,则行为未定义。
[edit] 返回值
size
,则为负值。[edit] 注释
虽然窄字符串提供 std::vsnprintf,这使得确定所需的输出缓冲区大小成为可能,但没有宽字符串的等效项,为了确定缓冲区大小,程序可能需要调用std::vswprintf
,检查结果值,并重新分配一个更大的缓冲区,直到成功为止。
[edit] 示例
此部分不完整 原因:没有示例 |
[edit] 另请参阅
将格式化的输出打印到 stdout、文件流或缓冲区 使用可变参数列表 (函数) | |
将格式化的宽字符输出打印到 stdout、文件流或缓冲区 (函数) | |
C 文档 for vwprintf, vfwprintf, vswprintf
|