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

1.1     ! root        1: .\"    @(#)putc.3      6.3 (Berkeley) 4/1/89
        !             2: .\"
        !             3: .TH PUTC 3  "April 1, 1989"
        !             4: .AT 3
        !             5: .SH NAME
        !             6: putc, putchar, fputc, putw \- put character or word on a stream
        !             7: .SH SYNOPSIS
        !             8: .B #include <stdio.h>
        !             9: .PP
        !            10: .B int putc(c, stream)
        !            11: .br
        !            12: .B char c;
        !            13: .br
        !            14: .SM
        !            15: .B FILE
        !            16: .B *stream;
        !            17: .PP
        !            18: .B int putchar(c)
        !            19: .PP
        !            20: .B int fputc(c, stream)
        !            21: .br
        !            22: .SM
        !            23: .B FILE
        !            24: .B *stream;
        !            25: .PP
        !            26: .B int putw(w, stream)
        !            27: .br
        !            28: .SM
        !            29: .B FILE
        !            30: .B *stream;
        !            31: .SH DESCRIPTION
        !            32: .I Putc
        !            33: appends the character
        !            34: .I c
        !            35: to the named output
        !            36: .IR stream .
        !            37: It returns the character written.
        !            38: .PP
        !            39: .IR Putchar ( c )
        !            40: is defined as 
        !            41: .IR putc ( c ,
        !            42: .BR stdout ).
        !            43: .PP
        !            44: .I Fputc
        !            45: behaves like 
        !            46: .IR putc ,
        !            47: but is a genuine function rather than a macro.
        !            48: .PP
        !            49: .I Putw
        !            50: appends word (that is,
        !            51: .BR int )
        !            52: .I w
        !            53: to the output
        !            54: .IR stream .
        !            55: It returns the word written.
        !            56: .I Putw
        !            57: neither assumes nor causes special alignment in the file.
        !            58: .SH "SEE ALSO"
        !            59: fopen(3),
        !            60: fclose(3),
        !            61: getc(3),
        !            62: puts(3),
        !            63: printf(3),
        !            64: fread(3)
        !            65: .SH DIAGNOSTICS
        !            66: These functions return the constant
        !            67: .SM
        !            68: .B EOF
        !            69: upon error.  Since this is a good integer,
        !            70: .IR  ferror (3)
        !            71: should be used to detect 
        !            72: .I putw
        !            73: errors.
        !            74: .SH BUGS
        !            75: Because it is implemented as a macro,
        !            76: .I putc
        !            77: treats a
        !            78: .I stream
        !            79: argument with side effects improperly.  In particular
        !            80: .IP "putc(c, *f++);"
        !            81: .PP
        !            82: doesn't work sensibly.
        !            83: .PP
        !            84: Errors can occur long after the call to
        !            85: .IR putc .

unix.superglobalmegacorp.com

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