projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| 1f4480e5 KM |
1 | .\" @(#)ungetc.3 4.1 (Berkeley) %G% |
| 2 | .\" | |
| 3 | .TH UNGETC 3S | |
| 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. | |
| 20 | That character will be returned by the next | |
| 21 | .I getc | |
| 22 | call on that stream. | |
| 23 | .I Ungetc | |
| 24 | returns | |
| 25 | .IR c . | |
| 26 | .PP | |
| 27 | One character of pushback is guaranteed provided | |
| 28 | something has been read from the stream and the stream is | |
| 29 | actually buffered. | |
| 30 | Attempts to push EOF are rejected. | |
| 31 | .PP | |
| 32 | .IR Fseek (3) | |
| 33 | erases all memory of pushed back characters. | |
| 34 | .SH "SEE ALSO" | |
| 35 | getc(3), setbuf(3), fseek(3) | |
| 36 | .SH DIAGNOSTICS | |
| 37 | .I Ungetc | |
| 38 | returns | |
| 39 | .SM | |
| 40 | .B EOF | |
| 41 | if it can't push a character back. |