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