Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

fputwc，putwc-将宽字符写入FILE流

语法

#include <stdio.h>
#include <wchar.h>

wint_t fputwc(wchar_t wc, FILE *stream);
wint_t putwc(wchar_t wc, FILE *stream);

说明

fputwc()函数与fputc(3)函数的宽字符等效。它将宽字符wc写入流。如果ferror(stream)变为true，则返回WEOF。如果发生宽字符转换错误，它将errno设置为EILSEQ并返回WEOF。否则，它将返回wc。

putwc()函数或宏函数与fputwc()相同。它可以实现为宏，并且可以多次评估其参数。没有理由使用它。

有关非锁定对象，请参见unlocked_stdio(3)。

返回值

如果没有发生错误，则fputwc()函数返回wc，或者返回WEOF表示错误。如果发生错误，则设置errno来指示原因。

错误说明

除了通常的，还有

EILSEQ

将wc转换为流的编码失败。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

POSIX.1-2001，POSIX.1-2008，C99。

备注

fputwc()的行为取决于当前语言环境的LC_CTYPE类别。

在没有传递给fopen(3)调用的附加信息的情况下，可以合理地预期fputwc()将实际写入对应于宽字符wc的多字节序列。

另外参见

fgetwc(3)，fputws(3)，unlocked_stdio(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。