2.11BSD#431 - /usr/man/cat3/putchar.0

PUTC(3S)	    UNIX Programmer's Manual		 PUTC(3S)


NAME
     putc, putchar, fputc, putw - put character or word on a
     stream

SYNOPSIS
     #include <stdio.h>

     int putc(c, stream)
     char c;
     FILE *stream;

     int putchar(c)

     int fputc(c, stream)
     FILE *stream;

     int putw(w, stream)
     FILE *stream;

DESCRIPTION
     Putc appends the character c to the named output stream.  It
     returns the character written.

     Putchar(c) is defined as putc(c, stdout).

     Fputc behaves like putc, but is a genuine function rather
     than a macro.

     Putw appends word (that is, int) w to the output stream.  It
     returns the word written.	Putw neither assumes nor causes
     special alignment in the file.

SEE ALSO
     fopen(3S), fclose(3S), getc(3S), puts(3S), printf(3S),
     fread(3S)

DIAGNOSTICS
     These functions return the constant EOF upon error.  Since
     this is a good integer, ferror(3S) should be used to detect
     putw errors.

BUGS
     Because it is implemented as a macro, putc treats a stream
     argument with side effects improperly.  In particular

     putc(c, *f++);

     doesn't work sensibly.

     Errors can occur long after the call to putc.


Printed 11/26/99	November 6, 1985			1