C++官网参考链接:https://cplusplus.com/reference/cwchar/vfwprintf/
函数
<cwchar>
vfwprintf
int vfwprintf (FILE* stream, const wchar_t* format, va_list arg);
将格式化的数据从可变实参列表写入流
将由format指向的C宽字符串写入stream,以与printf相同的方式替换任何格式说明符,但使用由arg标识的可变实参列表中的元素,而不是其他函数实参。
在内部,该函数从arg标识的列表中获取实参,就像对它使用了va_arg一样,因此arg的状态可能会被调用改变。
在任何情况下,arg都应该在调用之前的某个时刻由va_start初始化,并期望在调用之后的某个时刻由va_end释放。
文件中宽字符的外部表示形式是多字节字符:正如调用wcrtomb来转换每个宽字符(使用stream的内部mbstate_t对象),就可以获得这些多字节字符。
这相当于vfprintf(<cstdio>)的宽字符。
形参
stream
指向标识输出流的FILE对象的指针。
流还没有方向,或者是宽字符方向的(流上的第一个I/O操作决定它是面向字节的还是面向宽字符的,参见fwide)。
format
C宽字符串,包含一个格式字符串,该格式字符串遵循与printf中的format相同的规范(详细信息请参阅printf)。
注意,所有格式说明符的含义都与printf中的含义相同;因此,%lc应使用用于写宽字符(而不是%c),%ls应使用用于写宽字符串(而不是%s)。
arg
标识用va_start初始化的可变实参列表的一个值。
va_list是<cstdarg>中定义的特殊类型。
返回值
如果成功,则返回写入的字符总数。
如果发生写错误,则设置错误指示符(ferror)并返回负数。
如果在写入宽字符时发生多字节字符编码错误,则errno设置为EILSEQ并返回负数。
用例
/* vfprintf example */
#include <stdio.h>
#include <stdarg.h>
#include <wchar.h>
void WriteWideFormatted (FILE * stream, const wchar_t * format, ...)
{
va_list args;
va_start (args, format);
vfwprintf (stream, format, args);
va_end (args);
}
int main ()
{
FILE * pFile;
pFile = fopen ("myfile.txt","w");
WriteWideFormatted (pFile,L"Call with %d variable argument.\n",1);
WriteWideFormatted (pFile,L"Call with %d variable %ls.\n",2,L"arguments");
fclose (pFile);
return 0;
}
该示例演示了如何使用不同数量的实参调用WriteWideFormatted,这些实参依次传递给vfwprintf函数。
myfile.txt将包含:
另请参考
vfprintf Write formatted data from variable argument list to stream (function)
vwprintf Print formatted data from variable argument list to stdout (function)
vswprintf Write formatted data from variable argument list to sized buffer (function)
fwprintf Write formatted data to stream (function)
wprintf Print formatted data to stdout (function)