C语言 fwprintf用法及代码示例

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

用法:

int fwprintf (FILE* stream, const wchar_t* format, ...);

将格式化的数据写入流

写入由C指向的C宽字符串格式到流。如果格式包括格式说明符(以开头的子序列%)，后面的其他参数格式格式化并插入结果字符串中，以替换其各自的说明符。

之后格式参数，该函数至少期望与以下参数指定的数量一样多的附加参数格式。

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

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

参数

stream: 指向一个指针FILE标识输出流的对象。
信息流尚未定向，或者wide-oriented(流上的第一个I /O操作确定它是否是字节-或者宽的-面向，请参阅fwide)。
format: 包含格式字符串的C宽字符串，其格式与格式在printf但字符较宽(请参见printf有关详细信息)。
请注意，所有格式说明符的含义均与中的相同。printf;所以，%lc应该用来写宽字符(而不是%c)，也%ls应该用于宽字符串(而不是%s)。
... (additional arguments): 取决于格式字符串，函数可能需要一系列附加参数，每个参数都包含一个用于替换a的值格式说明符在里面格式字符串(或指向存储位置的指针，用于n)。
这些参数至少应与格式说明符。该函数将忽略其他参数。

返回值

成功后，将返回写入的字符总数。

如果发生写入错误，则错误指示(ferror)设置，并返回负数。

如果在写入宽字符时发生多字节字符编码错误，errno被设定为EILSEQ并返回负数。

示例

/* fwprintf example */
#include <stdio.h>
#include <wchar.h>

int main ()
{
   FILE * pFile;
   int n;
   wchar_t name [100];

   pFile = fopen ("myfile.txt","w");
   for (n=0 ; n<3 ; n++)
   {
     fwprintf (stdout, L"please, enter a name: ");
     fgetws (name, 100, stdin);
     fwprintf (pFile, L"Name %d: %s",n,name);
   }
   fclose (pFile);

   return 0;
}

本示例提示用户输入3次名称，然后将其写入myfile.txt每行以固定的长度(共19个字符+换行符)组成。
使用了两种格式标签：
%d：有符号十进制整数
%-10.10s：左对齐(-)，至少十个字符(10)，最多十个字符(.10)，细绳 (s)。
假设我们已经进入John，Jean-Francois和Yoko作为3个名字，myfile.txt将包含：

Name 1: John
Name 2: Jean-Franc
Name 3: Yoko

有关格式化的更多示例，请参见printf。

相关用法

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