xref: /original-bsd/lib/libc/stdio/ungetc.3 (revision 7e95f7c4)
@(#)ungetc.3 6.2 (Berkeley) 04/01/89

UNGETC 3 ""
.AT 3
NAME
ungetc - push character back into input stream
SYNOPSIS
#include <stdio.h>

ungetc(c, stream)

FILE *stream;

DESCRIPTION
Ungetc pushes the character c back on an input stream. That character will be returned by the next getc call on that stream. Ungetc 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.

Fseek (3) erases all memory of pushed back characters.

"SEE ALSO"
getc(3), setbuf(3), fseek(3)
DIAGNOSTICS
Ungetc returns EOF if it can't push a character back.