Section: Linux Programmer's Manual (3)
ungetwc - push back a wide character onto a FILE stream
wint_t ungetwc(wint_t wc, FILE *stream);
function is the wide-character equivalent of the
It pushes back a wide character onto
and returns it.
is an invalid wide character,
is a valid wide character, it is pushed back onto the stream
and thus becomes available for future wide-character read operations.
The file-position indicator is decremented by one or more.
indicator is cleared.
The backing storage of the file is not affected.
need not be the last wide-character read from the stream;
it can be any other valid wide character.
If the implementation supports multiple push-back operations in a row, the
pushed-back wide characters will be read in reverse order; however, only one
level of push-back is guaranteed.
when successful, or
For an explanation of the terms used in this section, see
POSIX.1-2001, POSIX.1-2008, C99.
The behavior of
depends on the
category of the
This page is part of release 5.02 of the Linux
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at