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).
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004