ungetwc(3W) — DG/UX R4.11



ungetwc(3W)                       SDK R4.11                      ungetwc(3W)


NAME
       ungetwc  - push wchart character back into input stream

SYNOPSIS
       #include <stdio.h>
       #include <widec.h>
       wintt ungetwc(wintt c, FILE *stream);

DESCRIPTION
       ungetwc inserts the wide (wchart) 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 (wchart)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 (wchart)
       character.

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


Licensed material--property of copyright holder(s)
Museum
