FGETWS - Linux手册页

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

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

InterfaceAttributeValue
fgetws()Thread safetyMT-Safe

遵循规范

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/