|
|
1.1 root 1: .\" @(#)ungetc.3 6.2 (Berkeley) 4/1/89
2: .\"
3: .TH UNGETC 3 "April 1, 1989"
4: .AT 3
5: .SH NAME
6: ungetc \- push character back into input stream
7: .SH SYNOPSIS
8: .B #include <stdio.h>
9: .PP
10: .B ungetc(c, stream)
11: .br
12: .SM
13: .B FILE
14: .B *stream;
15: .SH DESCRIPTION
16: .I Ungetc
17: pushes the character
18: .I c
19: back on an input stream. That character will be returned by the next
20: .I getc
21: call on that stream.
22: .I Ungetc
23: returns
24: .IR c .
25: .PP
26: One character of pushback is guaranteed provided
27: something has been read from the stream and the stream is actually buffered.
28: Attempts to push EOF are rejected.
29: .PP
30: .IR Fseek (3)
31: erases all memory of pushed back characters.
32: .SH "SEE ALSO"
33: getc(3),
34: setbuf(3),
35: fseek(3)
36: .SH DIAGNOSTICS
37: .I Ungetc
38: returns
39: .SM
40: .B EOF
41: if it can't push a character back.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.