C语言 vfwprintf用法及代码示例

C语言wchar头文件(wchar.h)中vfwprintf函数的用法及代码示例。

用法:

int vfwprintf (FILE* stream, const wchar_t* format, va_list arg);

将可变参数列表中的格式化数据写入流

写入由C指向的C宽字符串格式到流，替换任何格式说明符在相同的方式printf可以，但是使用由变量标识的变量参数列表中的元素arg而不是其他函数参数。

在内部，该函数从由以下项标识的列表中检索参数：arg仿佛va_arg被用于它，因此状态arg可能会因调用而改变。

在任何情况下，arg应该已经被初始化va_start在调用之前的某个时间点，预计它将被释放va_end调用结束后的某个时间点。

文件中宽字符的外部表示是多字节字符：这些字符的获取就像wcrtomb被称为转换每个宽字符(使用流的内部mbstate_t目的)。

这是宽字符等价于vfprintf(<cstdio>)。

参数

stream: 指向一个指针FILE标识输出流的对象。
信息流尚未定向，或者wide-oriented(流上的第一个I /O操作确定它是否是字节-或者宽的-面向，请参阅fwide)。
format: 包含格式字符串的C宽字符串，其格式与格式在printf(参考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将包含：

myfile.txt
`Call with 1 variable argument. Call with 2 variable arguments.`

相关用法

注：本文由纯净天空筛选整理自C标准库大神的英文原创作品 C vfwprintf function。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。