FGETWC - Linux手册页

时间:2019-08-20 18:00:34  来源:igfitidea点击:

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

InterfaceAttributeValue
fgetwc(),getwc()Thread safetyMT-Safe

遵循规范

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/