UNGETC

Section: Standard I/O Functions (3S)
Updated: August 1, 1992
Index Return to Main Contents

NAME

ungetc - push character back into input stream

SYNOPSIS

#include <stdio.h>

int ungetc(int c, FILE *stream);

DESCRIPTION

Ungetc pushes the character c (converted to an unsigned char) back on an input stream. That character will be returned by the next getc call on that stream.

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(3S), fsetpos(3S), or rewind(3S) erases all memory of pushed back characters.

RETURN VALUE

Ungetc returns the character pushed back after conversion, or EOF if unsuccessful.