ungetwc(3S)                                              ungetwc(3S)


       NAME
             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), setbuf(3S), stdio(3S), getwc(3S), widec(3S).



















                           Copyright 1994 Novell, Inc.               Page 1