Return to getc.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / stdio

Annotation of 43BSDReno/lib/libc/stdio/getc.3, revision 1.1

1.1     ! root        1: .\"    @(#)getc.3      6.3 (Berkeley) 4/1/89
        !             2: .\"
        !             3: .TH GETC 3  "April 1, 1989"
        !             4: .AT 3
        !             5: .SH NAME
        !             6: getc, getchar, fgetc, getw \- get character or word from stream
        !             7: .SH SYNOPSIS
        !             8: .B #include <stdio.h>
        !             9: .PP
        !            10: .B int getc(stream)
        !            11: .br
        !            12: .SM
        !            13: .B FILE
        !            14: .B *stream;
        !            15: .PP
        !            16: .B int getchar()
        !            17: .PP 
        !            18: .B int fgetc(stream)
        !            19: .br
        !            20: .SM
        !            21: .B FILE
        !            22: .B *stream;
        !            23: .PP
        !            24: .B int getw(stream)
        !            25: .br
        !            26: .SM
        !            27: .B FILE
        !            28: .B *stream;
        !            29: .SH DESCRIPTION
        !            30: .I Getc
        !            31: returns the next character from the named input
        !            32: .IR stream .
        !            33: .PP
        !            34: .IR Getchar ()
        !            35: is identical to 
        !            36: .IR getc ( stdin ) .
        !            37: .PP
        !            38: .I Fgetc
        !            39: behaves like 
        !            40: .IR getc ,
        !            41: but is a genuine function, not a macro;
        !            42: it may be used to save object text.
        !            43: .PP
        !            44: .I Getw
        !            45: returns the next
        !            46: .B int
        !            47: (a 32-bit integer on a VAX-11) from the named input
        !            48: .IR stream .
        !            49: It returns the constant
        !            50: .SM
        !            51: .B EOF
        !            52: upon end of file or error, but since that is a good
        !            53: integer value,
        !            54: .I feof
        !            55: and
        !            56: .IR  ferror (3)
        !            57: should be used to check the success of
        !            58: .IR getw .
        !            59: .I Getw
        !            60: assumes no special alignment in the file.
        !            61: .SH "SEE ALSO"
        !            62: clearerr(3),
        !            63: fopen(3),
        !            64: putc(3),
        !            65: gets(3),
        !            66: scanf(3),
        !            67: fread(3),
        !            68: ungetc(3)
        !            69: .SH DIAGNOSTICS
        !            70: These functions return the integer constant
        !            71: .SM
        !            72: .B EOF
        !            73: at end of file, upon read error,
        !            74: or if an attempt is made to read a file not opened by
        !            75: .IR fopen .
        !            76: The end-of-file condition is remembered,
        !            77: even on a terminal,
        !            78: and all subsequent attempts to read will return
        !            79: .B EOF
        !            80: until the condition is cleared with
        !            81: .IR clearerr (3).
        !            82: .SH BUGS
        !            83: Because it is implemented as a macro,
        !            84: .I getc
        !            85: treats a
        !            86: .I stream
        !            87: argument with side effects incorrectly.
        !            88: In particular,
        !            89: `getc(*f++);'
        !            90: doesn't work sensibly.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.