4.3BSD-UWisc/man/cat3/putc.3s

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
     _P_u_t_c appends the character _c to the named output _s_t_r_e_a_m.  It
     returns the character written.

     _P_u_t_c_h_a_r(_c) is defined as _p_u_t_c(_c, stdout).

     _F_p_u_t_c behaves like _p_u_t_c, but is a genuine function rather
     than a macro.

     _P_u_t_w appends word (that is, int) _w to the output _s_t_r_e_a_m.  It
     returns the word written.  _P_u_t_w 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, _f_e_r_r_o_r(3S) should be used to detect
     _p_u_t_w errors.

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

     putc(c, *f++);

     doesn't work sensibly.

     Errors can occur long after the call to _p_u_t_c.





Printed 12/27/86        November 6, 1985                        1