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

名称

fwide-设置并确定FILE流的方向

语法

#include <wchar.h>

int fwide(FILE *stream, int mode);

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

fwide()：

_XOPEN_SOURCE>= 500 || _ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L

说明

当mode为零时，fwide()函数确定流的当前方向。如果流是面向宽字符的，即允许宽字符I / O但不允许字符I / O，则它将返回正值。如果流是面向字节的，则它返回一个负值-即，如果允许char I / O但不允许使用宽字符I / O。如果流还没有方向，则返回零；否则，返回零。在这种情况下，下一个I / O操作可能会更改方向(如果是char I / O操作，则更改为面向字节；如果是宽字符I / O操作，则更改为面向宽字符)。

一旦流具有方向，就无法更改它并保持直到流关闭。

当mode为非零时，fwide()函数首先尝试设置流的方向(如果mode大于0，则设置为面向宽字符；如果mode小于0，则设置为面向字节)。然后，如上所述，它返回一个表示当前方向的值。

返回值

fwide()函数可以更改流的方向，然后返回流的方向。正的返回值表示面向宽字符。负的返回值表示面向字节。返回值为零表示不确定。

遵循规范

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

备注

可以通过带有％lc和％ls指令的fprintf(3)函数，将宽字符输出输出到面向字节的流。

可以通过带有％c和％s指令的fwprintf(3)函数将面向字符的输出输出到面向宽字符的流。

另外参见

fprintf(3)，fwprintf(3)

出版信息

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