osx man page for ungetc

Query: ungetc

OS: osx

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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
Related Man Pages
ungetwc(3) - mojave
ungetc(3) - mojave
ungetc(3) - osx
ungetc(3) - netbsd
ungetwc_l(3) - osx
Similar Topics in the Unix Linux Community
fopen and open
Replacing words in a file
How to create one's own pipe in one's own shell?
How to create one's own pipe in one's own shell?
Adding to an array in an external file, and adding elements to it.