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

名称

ungetwc-将宽字符推回FILE流

语法

#include <wchar.h>

wint_t ungetwc(wint_t wc, FILE *stream);

说明

ungetwc()函数与ungetc(3)函数的宽字符等效。它将宽字符推回流并返回。

如果wc是WEOF，则返回WEOF。如果wc是无效的宽字符，它将errno设置为EILSEQ并返回WEOF。

如果wc是有效的宽字符，它将被推回到流中，从而可用于将来的宽字符读取操作。文件位置指示符递减一个或多个。文件结束指示符被清除。文件的后备存储不受影响。

注意：wc不必是从流中读取的最后一个宽字符；它可以是任何其他有效的宽字符。

如果实现连续支持多个推回操作，则推回的宽字符将以相反的顺序读取；但是，只能保证一个级别的推回。

返回值

如果成功，则ungetwc()函数将返回wc；如果失败，则将返回WEOF。

属性

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

遵循规范

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

备注

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

另外参见

fgetwc(3)

出版信息

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