UNGETWC(3W-SVR4)    RISC/os Reference Manual     UNGETWC(3W-SVR4)



NAME
     ungetwc - push wchar_t character back into input stream

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

     int ungetwc(wchart c, FILE *stream);

DESCRIPTION
     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 EOF.

     fseek() erases all memory of inserted characters.

DIAGNOSTICS
     ungetwc() returns EOF if it cannot insert a wchar_t charac-
     ter.

SEE ALSO
     getwc(3W), fseek(3S), setbuf(3S), stdio(3S), widec(3W).

























                        Printed 11/19/92                   Page 1