FPUTWC - Linux手册页

时间:2019-08-20 18:01:07  来源:igfitidea点击:

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)。

InterfaceAttributeValue
fputwc(),putwc()Thread safetyMT-Safe

遵循规范

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/