C参考手册
文件输入/输出 | File input/output
vprintf_s
在标题中定义 <wchar.h> |
||
---|---|---|
-1 |
||
int vwprintf ( const wchar_t * format , va_list vlist ); |
(自C95以来) |
|
(直到C99) | ||
int vwprintf ( const wchar_t * restrict format , va_list vlist ); |
(自C99以来) |
|
-2 |
||
int vfwprintf ( FILE * stream , const wchar_t * format , va_list vlist ); |
(自C95以来) |
|
(直到C99) | ||
int vfwprintf ( FILE * restrict stream , |
(自C99以来) |
|
const wchar_t * restrict format , va_list vlist ); | ||
-3 |
||
int vswprintf ( wchar_t * buffer , size_t bufsz , |
(自C95以来) |
|
const wchar_t * format , va_list vlist ); |
(直到C99) |
|
int vswprintf ( wchar_t * restrict buffer , size_t bufsz , |
(自C99以来) |
|
const wchar_t * restrict format , va_list vlist ); | ||
int vwprintf_s ( const wchar_t * restrict format , va_list vlist ); |
-4 |
(自C11以来) |
int vfwprintf_s ( FILE * restrict stream , |
-5 |
(自C11以来) |
const wchar_t * restrict format , va_list vlist ); | ||
int vswprintf_s ( wchar_t * restrict buffer , rsize_t bufsz , |
-6 |
(自C11以来) |
const wchar_t * restrict format , va_list vlist ); | ||
int vsnwprintf_s ( wchar_t * restrict buffer , rsize_t bufsz , |
-7 |
(自C11以来) |
const wchar_t * restrict format , va_list vlist ); |
流 |
- |
输出宽流写入 |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
缓冲 |
- |
指向要写入的宽字符串的指针 |
||||||||||
bufsz |
- |
要写入的最大宽字符数 |
||||||||||
格式 |
- |
指向以空字符结尾的宽字符串的指针,指定如何解释数据。 |
||||||||||
格式字符串由普通的宽字符(除外%)组成,它们被不变地复制到输出流和转换规范中。每个转换规范具有以下格式: | ||||||||||||
介绍%人物 | ||||||||||||
(可选)一个或多个修改转换行为的标志: | ||||||||||||
-:转换的结果在字段内左对齐(默认情况下它是右对齐的) | ||||||||||||
+:带符号转换的符号总是预设为转换结果的前缀(默认情况下结果前面为减号,仅当它为负值时) | ||||||||||||
空格:如果签名转换的结果不是以符号字符开头,或者是空的,则空格会预设为结果。如果+标志存在,它将被忽略。 | ||||||||||||
#:执行转换的替代形式。请参阅下表以了解确切的效果,否则行为未定义。 | ||||||||||||
0:对于整数和浮点数转换,前导零用于填充字段而不是空格字符。对于整数,如果明确指定了精度,它将被忽略。对于使用此标志的其他转换会导致未定义的行为。如果-标志存在,它将被忽略。 | ||||||||||||
(可选)整数值或*指定最小字段宽度。如果需要,结果会填充空格字符(默认情况下),右侧对齐时填充空白字符,左侧填充右侧填充。在使用的情况下*,宽度由类型的附加参数指定int。如果参数的值是负数,则结果是-指定的标志和正的字段宽度。(注意:这是最小宽度:该值从不被截断。) | ||||||||||||
(可选) .后面跟随整数或者*或者既不指定转换的精度。在使用的情况下*,精度由类型的附加参数指定int。如果这个参数的值是负数,它将被忽略。如果既不使用数字也不*使用,则精度取为零。请参阅下表以了解精确度的确切影响。 | ||||||||||||
(可选) 长度修饰符,用于指定参数的大小 | ||||||||||||
转换格式说明符 | ||||||||||||
以下格式说明符可用: | ||||||||||||
转换 |
说明 |
参数类型 |
||||||||||
说明符 | ||||||||||||
长度修饰符 |
hh |
h |
(没有) |
l |
ll |
j |
z |
t |
L |
|||
(C99)。 |
(C99)。 |
(C99)。 |
(C99)。 |
(C99)。 |
||||||||
% |
写文字%。完整的转换规范必须是%%。 |
N / A |
N / A |
N / A |
N / A |
N / A |
N / A |
N / A |
N / A |
N / A |
||
c |
写一个字符。 |
N / A |
N / A |
int |
wint_t |
N / A |
N / A |
N / A |
N / A |
N / A |
||
参数首先被转换wchar_t为仿佛通过调用btowc。如果使用l修饰符,wint_t则首先将参数转换为wchar_t。 | ||||||||||||
s |
写入一个字符串 |
N / A |
N / A |
char* |
wchar_t* |
N / A |
N / A |
N / A |
N / A |
N / A |
||
参数必须是一个指向包含从初始转换状态开始的多字节字符序列的字符数组的初始元素的指针,该数组转换为宽字符数组,就像通过调用mbrtowc具有零初始化转换状态一样。Precision指定要写入的最大宽字符数。如果未指定Precision,则将每个宽字符写入并不包括第一个空终止符。如果使用l说明符,参数必须是指向数组的初始元素的指针wchar_t。 | ||||||||||||
d |
将有符号整数转换为十进制表示形式[ - ] dddd。 |
signed char |
short |
int |
long |
long long |
intmax_t |
签 size_t |
ptrdiff_t |
N / A |
||
i |
精度指定出现的最小位数。默认的精度是1。 |
|||||||||||
如果转换后的值和精度都是0没有字符的转换结果。 |
||||||||||||
o |
将无符号整数转换为八进制表示oooo。 |
unsigned char |
unsigned short |
unsigned int |
unsigned long |
unsigned long long |
uintmax_t |
size_t |
未签名的版本 ptrdiff_t |
N / A |
||
精度指定出现的最小位数。默认的精度是1。如果转换后的值和精度都是0没有字符的转换结果。在替代实现中,如果需要,可以增加精度以写入一个前导零。在这种情况下,如果转换后的值和精度都是0,0写入单个。 | ||||||||||||
x |
将无符号整数转换为十六进制表示hhhh。 |
N / A |
||||||||||
X |
使用x转换字母abcdef。 |
|||||||||||
使用X转换字母ABCDEF。 |
||||||||||||
精度指定出现的最小位数。默认的精度是1。如果转换后的值和精度都是0没有字符的转换结果。在替代实现中, 0x或者0X如果转换后的值不为零,则将其作为结果的前缀。 |
||||||||||||
u |
将无符号整数转换为十进制表示形式dddd。 |
N / A |
||||||||||
精度指定出现的最小位数。默认的精度是1。如果转换后的值和精度都是0没有字符的转换结果。 | ||||||||||||
f |
将浮点数转换为样式[ - ] ddd.ddd中的十进制表示法。 |
N / A |
N / A |
double |
double(C99) |
N / A |
N / A |
N / A |
N / A |
long double |
||
F |
精度指定小数点后面出现的最小位数。默认的精度是6。在替代实现中,即使没有数字跟随,小数点字符也会被写入。对于无穷大和非数字转换风格,请参阅注释。 |
|||||||||||
e |
将浮点数转换为十进制指数符号。 |
N / A |
N / A |
N / A |
N / A |
N / A |
N / A |
|||||
E |
对于e转换样式,使用[ - ] d.ddd e±dd。 |
|||||||||||
对于E转换样式,使用[ - ] d.ddd E±dd。 |
||||||||||||
指数至少包含两位数字,只有在必要时才使用更多数字。如果值是0,指数也是0。精度指定小数点后面出现的最小位数。默认的精度是6。在替代实现中,即使没有数字跟随,小数点字符也会被写入。对于无穷大和非数字转换风格,请参阅注释。 |
||||||||||||
a |
将浮点数转换为十六进制指数表示法。 |
N / A |
N / A |
N / A |
N / A |
N / A |
N / A |
|||||
A |
对于a转换样式,使用[ - ] 0xh.hhh p±d。 |
|||||||||||
(C99)。 |
对于A转换样式,使用[ - ] 0Xh.hhh P±d。如果参数不是标准化的浮点值,则 |
|||||||||||
第一个十六进制数字是0。如果值是0,指数也是0。精度指定小数点后面出现的最小位数。默认精度足以精确表示值。在替代实现中,即使没有数字跟随,小数点字符也会被写入。对于无穷大和非数字转换风格,请参阅注释。 |
||||||||||||
g |
根据值和精度将浮点数转换为十进制或十进制指数符号。 |
N / A |
N / A |
N / A |
N / A |
N / A |
N / A |
|||||
G |
对于g风格转换的转换与风格e或f将被执行。 |
|||||||||||
对于G风格转换的转换与风格E或F将被执行。 |
||||||||||||
让P等于精度如果非零,6如果没有指定精度,或者1如果精度是0。然后,如果具有样式的转换E将具有以下指数X: |
||||||||||||
如果P> X≥-4,转换是用式f或F和精度P - 1 - X。 |
||||||||||||
否则,转换采用样式e或E精度P - 1。 |
||||||||||||
除非请求替代表示,否则尾随零将被删除,如果没有剩余小数部分,小数点字符也会被删除。对于无穷大和非数字转换风格,请参阅注释。 |
||||||||||||
n |
将此调用到目前为止写入的字符数返回给该函数。 |
signed char* |
short* |
int* |
long* |
long long* |
intmax_t* |
签 size_t* |
ptrdiff_t* |
N / A |
||
结果写入参数指向的值。规范可能不包含任何标志,字段宽度或精度。 | ||||||||||||
p |
写一个实现定义的字符序列来定义一个指针。 |
N / A |
N / A |
void* |
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,等等)都在头中定义<inttypes.h>还(虽然PRIdMAX,PRIuMAX等是同义词%jd,%ju等)。 | ||||||||||||
内存写入转换说明符%n是安全漏洞的常见目标,其中格式字符串取决于用户输入,并且不受边界检查printf_s函数族的支持。 | ||||||||||||
每个转换说明符的操作之后都有一个序列点 ; 这允许将多个%n结果存储在相同的变量中,或者作为边缘情况,%n在相同的调用中打印由较早修改的字符串。 | ||||||||||||
如果转换规范无效,则行为未定义。 | ||||||||||||
VLIST |
- |
包含要打印的数据的变量参数列表 |
- 介绍
%
人物 - (可选)一个或多个修改转换行为的标志:
-
-
:转换的结果在字段内左对齐(默认情况下它是右对齐的) -
+
:带符号转换的符号总是预设为转换结果的前缀(默认情况下结果前面为减号,仅当它为负值时) -
空格:如果签名转换的结果不是以符号字符开头,或者是空的,则空格会预设为结果。如果
+
存在标志,则忽略它。 -
#
:执行转换的替代形式。请参阅下表以了解确切的效果,否则行为未定义。 -
0
:对于整数和浮点数转换,前导零用于填充字段而不是空格字符。对于整数,如果明确指定了精度,它将被忽略。对于使用此标志的其他转换会导致未定义的行为。如果-
存在标志,则忽略它。
-
- (可选)整数值或
*
指定最小字段宽度。如果需要,结果会填充空格字符(默认情况下),右侧对齐时填充空白字符,左侧填充右侧填充。在使用的情况下*
,宽度由类型的附加参数指定int
。如果参数的值是负数,则结果是-
指定的标志和正的字段宽度。(注意:这是最小宽度:该值从不被截断。)- (可选)
.
后面跟随整数或者*
或者既不指定转换的精度。在使用的情况下*
,精度由类型的附加参数指定int
。如果这个参数的值是负数,它将被忽略。如果既不使用数字也不*
使用,则精度取为零。请参阅下表以了解精确度的确切影响。 - (可选)长度修饰符,用于指定参数的大小
- 转换格式说明符
- (可选)
返回值
1-3)如果发生错误,则写入的字符数如果成功或为负值。
4)如果发生错误,则成功写入字符数或写入负值。如果由于buf_size
限制而导致结果字符串被截断,则函数将返回如果未施加该限制的情况下将被写入的字符总数(不包括终止空字节)。
5,6)传输到输出流的字符数或负值(如果发生输出错误,运行时间约束违规错误或编码错误)。
7)写入的字符数buffer
,不包括空字符(只要buffer
不是空指针,bufsz
并且不为零且不大于RSIZE_MAX
),则不计入空字符,或者在运行时约束违规时为零,编码错误为负值
8)不包括终止空字符的字符数(只要buffer
不是空指针并且bufsz
不为零且不大于RSIZE_MAX
),buffer
如果bufsz
被忽略,将被写入的字符数或者如果运行时约束违规或编码错误发生
注意
所有这些函数va_arg
至少调用一次,arg
返回后的值是不确定的。这些函数不会调用va_end
,并且它必须由调用者完成。
vsnprintf_s
不像vsprintf_s
,会截断结果以适应指向的数组buffer
。
例
#include <stdio.h>
#include <stdarg.h>
#include <time.h>
void debug_log(const char *fmt, ...)
{
struct timespec ts;
timespec_get(&ts, TIME_UTC);
char time_buf[100];
size_t rc = strftime(time_buf, sizeof time_buf, "%D %T", gmtime(&ts.tv_sec));
snprintf(time_buf + rc, sizeof time_buf - rc, ".%06ld UTC", ts.tv_nsec / 1000);
va_list args1;
va_start(args1, fmt);
va_list args2;
va_copy(args2, args1);
char buf[1+vsnprintf(NULL, 0, fmt, args1)];
va_end(args1);
vsnprintf(buf, sizeof buf, fmt, args2);
va_end(args2);
printf("%s [debug]: %s\n", time_buf, buf);
}
int main(void)
{
debug_log("Logging, %d, %d, %d", 1, 2, 3);
}
可能的输出:
02/20/15 21:58:09.072683 UTC [debug]: Logging, 1, 2, 3