fputws-c和c++标准函数

C&C++标准库

fputws

函数 <cwchar>

int fputws (const wchar_t* ws, FILE* stream);

向流中写入宽字符串

将ws指向的C宽字符串写入流。

函数从指定的地址(ws)开始复制，直到到达结束的空宽字符。此结束空宽字符不会复制到流中。

文件中宽字符的外部表示是多字节字符:获取这些字符时，就好像调用了wcrtomb 来转换每个宽字符(使用流的内部mbstate_t对象)。

这相当于 fputs (<cstdio>)的宽字符版本。

☲ 参数

ws
要写入流的宽字符串。

stream
指向标识输出流的FILE对象的指针。
流不区分字符模式（流上的第一次i/o操作确定它是单字符还是宽字符，请参见fwide）。

☉ 返回值

如果成功，则返回一个非负值。
如果出现多字节字符编码错误，则将errno 设置为EILSEQ并返回EOF。
如果发生写错误，该函数将设置错误指示符(ferror)并返回EOF。

☣ 示例

/* fputws example */
#include <stdio.h>

int main ()
{
   FILE * pFile;
   wchar_t sentence [256];

   wprintf (L"Enter sentence to append: ");
   fgetws (sentence,255,stdin);
   pFile = fopen ("mylog.txt","a");
   fputws (sentence,pFile);
   fclose (pFile);
   return 0;
}

这个程序允许在每次运行时向名为mylog.txt的文件追加一行。

🍄 另请参阅

fputs	向流中写入字符串(function )
fputwc	向流中写入宽字符(function )
fgetws	从流读取宽字符串(function )
fwprintf	将格式化的数据写入流(function )