4.3BSD-UWisc/man/cat3/ungetc.3s

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
     getc(3S), setbuf(3S), fseek(3S)

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






























Printed 12/27/86          May 15, 1985                          1