hpux man page for ungetc

ungetc(3S)																ungetc(3S)

NAME
       ungetc()  - push character back into input stream

SYNOPSIS
   Obsolescent Interface
DESCRIPTION
       inserts the character c (converted to an unsigned char) into the buffer associated with an input stream.  That character, c, is returned by
       the next call to (see getc(3S)) on that stream.	A successful intervening call to a file positioning function with  stream  or  erases  all
       memory of the inserted characters.

       affects only the buffer associated with the input stream.  It does not affect the contents of the file corresponding to stream.

       One character of pushback is guaranteed.

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

   Obsolescent Interface
       pushes character back into input stream.

APPLICATION USAGE
       After is applied to a stream, the stream becomes byte-oriented (see orientation(5)).

RETURN VALUE
       If successful, and return c and clear the end-of-file indicator for the stream.	and return EOF if they cannot insert the character.

WARNINGS
       is an obsolescent interface supported only for compatibility with existing DCE applications.  New multithreaded applications should use

SEE ALSO
       flockfile(3S), fseek(3S), fgetpos(3S), getc(3S), setbuf(3S), orientation(5), thread_safety(5).

STANDARDS CONFORMANCE
																	ungetc(3S)