[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    ungetc(3S) manual page Table of Contents

Name

ungetc - push character back onto input stream

Synopsis

#include <stdio.h>

int ungetc(int c, FILE *stream);

MT-Level

MT-Safe

Description

ungetc() inserts the character specified by c (converted to an unsigned char) into the buffer associated with an input stream (see intro(3) ). That character, c, will be returned by the next getc(3S) call on that stream. ungetc() returns c, and leaves the file corresponding to stream unchanged. A successful call to ungetc() clears the EOF indicator for stream.

Four bytes of pushback are guaranteed.

The value of the file position indicator for stream after reading or discarding all pushed-back characters will be the same as it was before the characters were pushed back.

If c equals EOF , ungetc() does nothing to the buffer and returns EOF .

fseek(), rewind() (both described on fseek(3S) ), and fsetpos(3C) erase the memory of inserted characters for the stream on which they are applied.

Return Values

ungetc() returns EOF if it cannot insert the character.

See Also

intro(3) , fseek(3S) , fsetpos(3C) , getc(3S) , setbuf(3S) , stdio(3S)

Table of Contents