ungetwc(3S)							   ungetwc(3S)

NAME    [Toc]    [Back]

     ungetwc  -	push wchar_t character back into input stream

SYNOPSIS    [Toc]    [Back]

     #include <stdio.h>
     #include <widec.h>

     wint_t ungetwc(wchar_t c<b>, FILE *stream<b>);

DESCRIPTION (International Functions)    [Toc]    [Back]

     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
     WEOF.

     fseek erases all memory of	inserted characters.

SEE ALSO    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

     ungetwc returns WEOF if it	cannot insert a	wchar_t	character.


									PPPPaaaaggggeeee 1111