C 参考手册
- C 语言
- C 关键词
- 预处理器
- C 标准库头文件
- 类型支持
- 程序支持工具
- 变参数函数
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 算法
- 数值
- 文件输入/输出
- gets, gets_s
- printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s
- fopen, fopen_s
- fputc, putc
- fputs
- getchar
- putchar
- FILE
- fpos_t
- stdin, stdout, stderr
- freopen, freopen_s
- fwide
- setbuf
- setvbuf
- fclose
- fflush
- fread
- fwrite
- fgetc, getc
- fgets
- puts
- ungetc
- fgetwc
- fgetws
- fputwc, putwc
- fputws
- getwchar
- putwchar
- ungetwc
- scanf, fscanf, sscanf, scanf_s, fscanf_s, sscanf_s
- wscanf, fwscanf, swscanf, wscanf_s, fwscanf_s, swscanf_s
- vscanf, vfscanf, vsscanf, vscanf_s, vfscanf_s, vsscanf_s
- vwscanf, vfwscanf, vswscanf, vwscanf_s, vfwscanf_s, vswscanf_s
- wprintf, fwprintf, swprintf, wprintf_s, fwprintf_s, swprintf_s, snwprintf_s
- vprintf, vfprintf, vsprintf, vsnprintf, vprintf_s, vfprintf_s, vsprintf_s, vsnprintf_s
- vwprintf, vfwprintf, vswprintf, vwprintf_s, vfwprintf_s, vswprintf_s, vsnwprintf_s
- ftell
- fgetpos
- fseek
- fsetpos
- rewind
- clearerr
- feof
- ferror
- perror
- remove
- rename
- tmpfile, tmpfile_s
- tmpnam, tmpnam_s
- 本地化支持
- 原子操作库
- 线程支持库
- 实验性 C 标准库
- 有用的资源
- 符号索引
- 注释
ungetwc
定义于头文件 <wchar.h>
|
||
wint_t ungetwc( wint_t ch, FILE *stream ); |
(C95 起) | |
若 ch
不等于 WEOF ,则推入宽字符 ch
到与流 stream
关联的输入缓冲区,方式满足从 stream
的后继读取操作将取得该宽字符。不修改与流关联的外部设备。
流重寻位操作 fseek 、 fsetpos 和 rewind 弃去 ungetwc
的效果。
若调用 ungetwc
多于一次,而无中间读取或重寻位,则可能失败(换言之,保证大小为 1 的回放缓冲区,但任何更大的缓冲区是实现定义的)。若成功进行多次 ungetwc
,则读取操作以 ungetwc
的逆序取得回放的宽字符。
若 ch
等于 WEOF ,则操作失败而不影响流。
对 ungetwc
的成功调用清除文件尾状态标志 feof 。
在流(无论文本还是二进制)上对 ungetwc
的成功调用以未指定方式修改流位置指示器,但保证在以读取操作取得所有回放的宽字符后,流位置指示器等于其在 ungetwc
之前的值。
参数
ch | - | 要被回放的宽字符 |
stream | - | 要回放宽字符到的文件流 |
返回值
成功时返回 ch
。
失败时返回 WEOF ,而给定的流保持不变。
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.29.3.10 The ungetwc function (p: 425-426)
- C99 standard (ISO/IEC 9899:1999):
- 7.24.3.10 The ungetwc function (p: 370-371)
参阅
将一个字符送回文件流 (函数) | |
(C95) |
从文件流获取一个宽字符 (函数) |