UNGETC
Section: C Library Functions (3)
Index
Return to Main Contents
BSD mandoc
NAME
ungetc
- un-get character from input stream
SYNOPSIS
Fd #include <stdio.h>
Ft int
Fn ungetc int c FILE *stream
DESCRIPTION
The
Fn ungetc
function pushes the character
Fa c
(converted to an unsigned char)
back onto the input stream pointed to by
Fa stream .
The pushed-backed characters will be returned by subsequent reads on the
stream (in reverse order).
A successful intervening call, using the same stream, to one of the file
positioning functions
Po fseek(3),
fsetpos(3),
or
rewind(3)
Pc will discard the pushed back characters.
One character of push-back is guaranteed,
but as long as there is
sufficient memory, an effectively infinite amount of pushback is allowed.
If a character is successfully pushed-back,
the end-of-file indicator for the stream is cleared.
RETURN VALUES
The
Fn ungetc
function
returns
the character pushed-back after the conversion, or
EOF
if the operation fails.
If the value of the argument
Fa c
character equals
EOF
the operation will fail and the stream will remain unchanged.
SEE ALSO
getc(3),
fseek(3),
setvbuf(3)
STANDARDS
The
Fn ungetc
function conforms to
St -ansiC .
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- SEE ALSO
-
- STANDARDS
-
This document was created by
man2html,
using the manual pages.
Time: 15:52:53 GMT, January 15, 2023