C++ Reference: Standard C++ Library reference: C Library: cwchar: vfwprintf

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将包含：