ungetwc(3S)

NAME
     ungetwc  - push wchar_t character back into input stream

SYNOPSIS
     #include <stdio.h>
     #include <widec.h>
     int ungetwc(wchar_t c, FILE *stream);

DESCRIPTION (International Functions)
     ungetwc inserts the wchar_t character c into the buffer associated with
     the input stream.  That character, c, will be returned by the next getwc
     call on that stream.  ungetwc returns c.

     One character of pushback is guaranteed, provided something has already
     been read from the stream and the stream is actually buffered.

     If c equals (wchar_t)EOF, ungetwc does nothing to the buffer and returns
     EOF.

     fseek erases all memory of inserted characters.

SEE ALSO
     fseek(3S), setbuf(3S), stdio(3S), getwc(3S), widec(3S).

DIAGNOSTICS
     ungetwc returns EOF if it cannot insert a wchar_t character.