ungetwc(3S)

ungetwc -- push wchar_t character back into input stream

Synopsis

   #include <stdio.h>
   #include <widec.h>
   
   wint_t ungetwc(wint_t c, FILE stream);

Description

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

One wide 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)WEOF, ungetwc does nothing to the buffer and returns WEOF.

fseek erases all memory of inserted characters.

Errors

ungetwc returns WEOF if it cannot insert the wide (wchar_t) character.

References

fseek(3S), Intro(3S), setbuf(3S), getwc(3S), widec(3S).