Linux程序员手册 第3部分
更新日期： 2015-08-08

名称

fgetwc，getwc-从FILE流中读取宽字符

语法

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

wint_t fgetwc(FILE *stream);
wint_t getwc(FILE *stream);

说明

fgetwc()函数与fgetc(3)函数的宽字符等效。它从流中读取一个宽字符并将其返回。如果到达流的末尾，或者ferror(stream)变为true，则返回WEOF。如果发生宽字符转换错误，它将errno设置为EILSEQ并返回WEOF。

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

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

返回值

fgetwc()函数返回流中的下一个宽字符，即WEOF。如果发生错误，则设置errno来指示原因。

错误说明

除了通常的，还有

EILSEQ

从输入流获得的数据不构成有效字符。

属性

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

遵循规范

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

备注

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

在没有传递给fopen(3)调用的附加信息的情况下，可以合理地预期fgetwc()实际上将从流中读取多字节序列，然后将其转换为宽字符。

另外参见

fgetws(3)，fputwc(3)，ungetwc(3)，unlocked_stdio(3)

出版信息

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