Linux程序员手册 第3部分
更新日期： 2019-03-06

名称

fgetws-从FILE流中读取一个宽字符字符串

语法

#include <wchar.h>

wchar_t *fgetws(wchar_t *ws, int n, FILE *stream);

说明

fgetws()函数与fgets(3)函数的宽字符等效。它将最多n-1个宽字符的字符串读入ws指向的宽字符数组中，并添加一个终止的空宽字符(Laq \ 0aq)。遇到并存储换行符后，它将停止读取宽字符。当到达流结束时，它也会停止。

程序员必须确保在ws处至少有n个宽字符的空间。

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

返回值

如果成功，fgetws()函数将返回ws。如果已经到达流的末尾或发生错误，则返回NULL。

属性

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

遵循规范

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

备注

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

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

此函数不可靠，因为它不允许正确处理输入中可能存在的null宽字符。

另外参见

fgetwc(3)，unlocked_stdio(3)

出版信息

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