UNGETC(3S)          UNIX Programmer's Manual           UNGETC(3S)

NAME
     ungetc - push character back into input stream

SYNOPSIS
     #include <stdio.h>

     ungetc(c, stream)
     FILE *stream;

DESCRIPTION
     _U_n_g_e_t_c pushes the character _c back on an input stream.  That
     character will be returned by the next _g_e_t_c call on that
     stream.  _U_n_g_e_t_c returns _c.

     One character of pushback is guaranteed provided something
     has been read from the stream and the stream is actually
     buffered.  Attempts to push EOF are rejected.

     _F_s_e_e_k(3S) erases all memory of pushed back characters.

SEE ALSO
     fseek(3S), getc(3S), setbuf(3S)

DIAGNOSTICS
     _U_n_g_e_t_c returns EOF if it can't push a character back.

Printed 5/24/83                                                 1