UNGETWC(3) NEWLIB UNGETWC(3)NAME
4.67 `ungetwc'--push wide character data back into a stream
SYNOPSIS
#include <stdio.h>
#include <wchar.h>
wint_t ungetwc(wint_t WC, FILE *STREAM);
wint_t _ungetwc_r(struct _reent *REENT, wint_t WC, FILE *STREAM);
DESCRIPTION
`ungetwc' is used to return wide characters back to STREAM to be read
again. If WC is WEOF, the stream is unchanged. Otherwise, the wide
character WC is put back on the stream, and subsequent reads will see
the wide chars pushed back in reverse order. Pushed wide chars are
lost if the stream is repositioned, such as by `fseek', `fsetpos', or
`rewind'.
The underlying file is not changed, but it is possible to push back
something different than what was originally read. Ungetting a charac‐
ter will clear the end-of-stream marker, and decrement the file posi‐
tion indicator. Pushing back beyond the beginning of a file gives
unspecified behavior.
The alternate function `_ungetwc_r' is a reentrant version. The
extra argument REENT is a pointer to a reentrancy structure.
RETURNS
The wide character pushed back, or `WEOF' on error.
PORTABILITY
C99
SEE ALSOungetwc is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 UNGETWC(3)
