ungetc(3s) [hpux man page]

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)

UNGETC(3)						   BSD Library Functions Manual 						 UNGETC(3)

NAME

     ungetc -- un-get character from input stream

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <stdio.h>

     int
     ungetc(int c, FILE *stream);

DESCRIPTION

     The ungetc() function pushes the character c (converted to an unsigned char) back onto the input stream pointed to by stream.  The pushed-
     back characters will be returned (in reverse order) by subsequent reads on the stream.  A successful intervening call to one of the file
     positioning functions (fseek(3), fsetpos(3), or rewind(3)), using the same stream, will discard the pushed-back characters.

     Only one character of push-back is guaranteed, but as long as there is sufficient memory, an effectively infinite amount of push-back is
     allowed.

     If a character is successfully pushed-back, the end-of-file indicator for the stream is cleared.  The file-position indicator is decremented
     by each successful call to ungetc(); if its value was 0 before a call, its value is unspecified after the call.

RETURN VALUES

     The ungetc() function returns the character pushed-back after the conversion, or EOF if the operation fails.  If the value of the argument c
     character equals EOF, the operation will fail and the stream will remain unchanged.

SEE ALSO

     fseek(3), getc(3), setvbuf(3), ungetwc(3)

STANDARDS

     The ungetc() function conforms to ISO/IEC 9899:1990 (``ISO C90'').

BSD
								   June 4, 1993 							       BSD