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

C++官网参考链接：https://cplusplus.com/reference/cwchar/vwprintf/

函数 

vwprintf
int vwprintf (const wchar_t* format, va_list arg);
将格式化的数据从可变实参列表打印到标准输出 
将由format指向的C宽字符串写入标准输出（stdout），以与printf相同的方式替换任何格式说明符，但使用由arg标识的可变实参列表中的元素，而不是其他函数实参。
在内部，该函数从arg标识的列表中获取实参，就像对它使用了va_arg一样，因此arg的状态可能会被调用改变。
在任何情况下，arg都应该在调用之前的某个时刻由va_start初始化，并期望在调用之后的某个时刻由va_end释放。
在stdout中宽字符的外部表示形式是多字节字符：就像调用wcrtomb来转换每个宽字符（使用流的内部mbstate_t对象）一样获得这些多字节字符。
这相当于vprintf（）的宽字符。

形参 
format 
C宽字符串，包含一个格式字符串，该格式字符串遵循与printf中的format相同的规范（详细信息请参阅printf）。
注意，所有格式说明符的含义都与printf中的含义相同；因此，%lc应使用用于写宽字符（而不是%c）， %ls应使用用于写宽字符串（而不是%s）。
arg 
一个值，标识用va_start初始化的可变实参列表。
va_list是中定义的特殊类型。

返回值
如果成功，则返回写入的字符总数。
如果发生写错误，则设置错误指示符（ferror）并返回负数。
如果在写入宽字符时发生多字节字符编码错误，则errno设置为EILSEQ并返回负数。

用例
/* vwprintf example */
#include
#include

void WriteWideFormatted ( const wchar_t * format, ... )
{
  va_list args;
  va_start (args, format);
  vwprintf (format, args);
  va_end (args);
}

int main ()
{
   WriteWideFormatted (L"Call with %d variable argument.\n",1);
   WriteWideFormatted (L"Call with %d variable %ls.\n",2,L"arguments");

   return 0;
}
输出：

另请参考
vprintf    Print formatted data from variable argument list to stdout (function)
wprintf    Print formatted data to stdout (function)
printf    Print formatted data to stdout (function)