42 lines
782 B
Groff
42 lines
782 B
Groff
|
.\" @(#)ungetc.3s 6.1 (Berkeley) 5/15/85
|
||
|
|
.\"
|
||
|
|
.TH UNGETC 3 "May 15, 1985"
|
||
|
|
.AT 3
|
||
|
|
.SH NAME
|
||
|
|
ungetc \- push character back into input stream
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.nf
|
||
|
|
.ft B
|
||
|
|
#include <stdio.h>
|
||
|
|
|
||
|
|
int ungetc(int \fIc\fP, FILE *\fIstream\fP)
|
||
|
|
.ft R
|
||
|
|
.fi
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B Ungetc
|
||
|
|
pushes the character
|
||
|
|
.I c
|
||
|
|
back on an input stream. That character will be returned by the next
|
||
|
|
.B getc
|
||
|
|
call on that stream.
|
||
|
|
.B Ungetc
|
||
|
|
returns
|
||
|
|
.IR c .
|
||
|
|
.PP
|
||
|
|
One character of pushback is guaranteed provided
|
||
|
|
something has been read from the stream and the stream is actually buffered.
|
||
|
|
Attempts to push EOF are rejected.
|
||
|
|
.PP
|
||
|
|
.BR Fseek (3)
|
||
|
|
erases all memory of pushed back characters.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.BR getc (3),
|
||
|
|
.BR setbuf (3),
|
||
|
|
.BR fseek (3).
|
||
|
|
.SH DIAGNOSTICS
|
||
|
|
.B Ungetc
|
||
|
|
returns
|
||
|
|
.SM
|
||
|
|
.B EOF
|
||
|
|
if it can't push a character back.
|