wprintf, fwprintf, swprintf, wprintf_s, fwprintf_s, swprintf_s, snwprintf_s
定义于头文件 <wchar.h>
|
||
(1) | ||
int wprintf( const wchar_t *format, ... ); |
(C95 起) (C99 前) |
|
int wprintf( const wchar_t *restrict format, ... ); |
(C99 起) | |
(2) | ||
int fwprintf( FILE *stream, const wchar_t* format, ... ); |
(C95 起) (C99 前) |
|
int fwprintf( FILE *restrict stream, const wchar_t *restrict format, ... ); |
(C99 起) | |
(3) | ||
int swprintf( wchar_t *buffer, size_t bufsz, const wchar_t* format, ... ); |
(C95 起) (C99 前) |
|
int swprintf( wchar_t *restrict buffer, size_t bufsz, const wchar_t *restrict format, ... ); |
(C99 起) | |
int wprintf_s( const wchar_t *restrict format, ...); |
(4) | (C11 起) |
int fwprintf_s( FILE *restrict stream, const wchar_t *restrict format, ...); |
(5) | (C11 起) |
int swprintf_s( wchar_t *restrict buffer, rsize_t bufsz, const wchar_t* restrict format, ...); |
(6) | (C11 起) |
int snwprintf_s( wchar_t * restrict s, rsize_t n, const wchar_t * restrict format, ...); |
(7) | (C11 起) |
从给定位置加载数据,将它们转换成宽字符串等价物并将结果写入各种池中。
stream
。bufsz
大于零,则写结果到宽字符串buffer
。至多允许写入后随空宽字符的bufsz-1个宽字符。若bufsz
为零,则不写入任何内容(且buffer
可以是空指针)然而返回值(会被写入的宽字符数)被照样计算并返回。-
format
中存在转换指定符%n
- 任何一个对应
%s
的参数是空指针 -
format
或buffer
是空指针 -
bufsz
为零或大于 RSIZE_MAX - 任何一个字符串及字符转换指定符中出现编码错误
- (仅对于
swprintf_s
)会写入的宽字符数含空宽字符,将超出bufsz
。
-
- 同所有边界检查函数,
wprintf_s, fwprintf_s, swprintf_s, snwprintf_s
仅若实现定义了 __STDC_LIB_EXT1__ ,且用户在包含<wchar.h>
前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。
参数
stream | - | 要写入的输出文件流 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
buffer | - | 指向要写入的宽字符串的指针 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bufsz | - | 最多会写入 bufsz - 1 个宽字符,再加空终止符 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
format | - | 指向指定数据转译方式的空终止宽字符串的指针。
格式字符串由普通宽字符(除了
下列格式指定符可用:
浮点转换函数转换无穷大到 非数转换成 转换 尽管 定宽整数类型( int8_t 等)的正确转换指定定义于头文件 <inttypes.h> (尽管 PRIdMAX 、 PRIuMAX 等就是 内存写入转换指定符 %n 是安全漏洞的常见目标,这里格式字符串依赖用户输入,而有边界检查的 在每个转换指定符的行动后有一个序列点;这允许于同一变量多次存入 %n 的结果,并在同一此调用中打印出先前以 %n 存储的值。 若转换指定非法,则行为未定义。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
... | - | 指定要打印数据的参数。若任何参数在默认参数提升后不拥有对应转换指定符所期待的类型,或若参数少于 format 所要求的数量,则行为未定义。若有多于 format 所要求的参数,则求值并忽略额外参数
|
返回值
size
(含 size
为零时)则为负值。buffer
的宽字符数(不计空终止符)。编码错误发生和溢出时返回负值。所有其他错误发生时返回零。bufsz
充分大则本应写入 buffer
的宽字符数(不计空终止符),或者若错误发生则为负值。(即写入成功仅当返回值非负且小于 bufsz
)。注意
窄字符串提供 snprintf ,它使得确定需求的缓冲区大小可行,不过宽字符串无等价物(在 C11 的 snwprintf_s 前),而为了确定缓冲区大小,程序可能需要调用 swprintf ,检查返回值,并重分配更大的缓冲区,反复尝试直至成功。
不同于 swprintf_s
, snwprintf_s
将截断结果以适应 buffer
所指向的数组,尽管这种截断被多数边界检查函数当做错误。
示例
#include <locale.h> #include <wchar.h> int main(void) { char narrow_str[] = "z\u00df\u6c34\U0001f34c"; // 或 "zß水🍌" // 或 "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c"; wchar_t warr[29]; // 期待的字符串为 28 字节加 1 个空终止符 setlocale(LC_ALL, "en_US.utf8"); swprintf(warr, sizeof warr/sizeof *warr, L"Converted from UTF-8: '%s'", narrow_str); wprintf(L"%ls\n", warr); }
输出:
Converted from UTF-8: 'zß水🍌'
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.29.2.1 The fwprintf function (p: 403-410)
- 7.29.2.3 The swprintf function (p: 416)
- 7.29.2.11 The wprintf function (p: 421)
- K.3.9.1.1 The fwprintf_s function (p: 628)
- K.3.9.1.4 The swprintf_s function (p: 630-631)
- K.3.9.1.13 The wprintf_s function (p: 637-638)
- C99 standard (ISO/IEC 9899:1999):
- 7.24.2.1 The fwprintf function (p: 349-356)
- 7.24.2.3 The swprintf function (p: 362)
- 7.24.2.11 The wprintf function (p: 366)
参阅
(C99)(C11)(C11)(C11)(C11) |
打印格式化输出到 stdout 、文件流或缓冲区 (函数) |
(C95)(C95)(C95)(C11)(C11)(C11)(C11) |
打印格式化宽字符输出到 stdout 、文件流或缓冲区 使用可变参数列表 (函数) |
(C95) |
将一个宽字符串写入文件流 (函数) |