PUTC(3S)                                                              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.



7th Edition                    November 6, 1985                       PUTC(3S)