ungetwc - push back a wide character onto a FILE stream
SYNOPSIS
#include <wchar.h>
wint_t ungetwc (wint_t wc, FILE *stream);
DESCRIPTION
The ungetwc function is the wide-character equivalent of
the ungetc function. It pushes back a wide character onto
stream and returns it.
If wc is WEOF, it returns WEOF. If wc is an invalid wide
character, it sets errno to EILSEQ and returns WEOF.
If wc 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. The end-of-file indicator is
cleared. The backing storage of the file is not affected.
Note: wc 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 opera
tions in a row, the pushed-back wide characters will be
read in reverse order; however, only one level of push-
back is guaranteed.
RETURN VALUE
The ungetwc function returns wc when successful, or WEOF
upon failure.
CONFORMING TO
ISO/ANSI C, UNIX98
SEE ALSO
fgetwc(3)
NOTES
The behaviour of ungetwc depends on the LC_CTYPE category
of the current locale.
Man(1) output converted with
man2html