ungetwc

From cppreference.net

< c ‎ | io

Types and objects

Functions

File access

Unformatted input/output

Formatted input

scanf fscanf sscanf scanf_s fscanf_s sscanf_s (C11) (C11) (C11)
wscanf fwscanf swscanf wscanf_s fwscanf_s swscanf_s (C95) (C95) (C95) (C11) (C11) (C11)

vscanf vfscanf vsscanf vscanf_s vfscanf_s vsscanf_s (C99) (C99) (C99) (C11) (C11) (C11)
vwscanf vfwscanf vswscanf vwscanf_s vfwscanf_s vswscanf_s (C99) (C99) (C99) (C11) (C11) (C11)

Direct input/output

Formatted output

printf fprintf sprintf snprintf printf_s fprintf_s sprintf_s snprintf_s (C99) (C11) (C11) (C11) (C11)
wprintf fwprintf swprintf wprintf_s fwprintf_s swprintf_s snwprintf_s (C95) (C95) (C95) (C11) (C11) (C11) (C11)

vprintf vfprintf vsprintf vsnprintf vprintf_s vfprintf_s vsprintf_s vsnprintf_s (C99) (C11) (C11) (C11) (C11)
vwprintf vfwprintf vswprintf vwprintf_s vfwprintf_s vswprintf_s vsnwprintf_s (C95) (C95) (C95) (C11) (C11) (C11) (C11)

File positioning

Error handling

clearerr
feof

ferror
perror

Operations on files

remove
tmpfile tmpfile_s (C11)

rename
tmpnam tmpnam_s (C11)

定义于头文件 `<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	-	要回退宽字符的文件流