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

NNAAMMEE
     ffppuuttcc, ppuuttcc, ppuuttcchhaarr, ppuuttww - output a character or word to a stream

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssttddiioo..hh>>

     _i_n_t
     ffppuuttcc(_i_n_t _c, _F_I_L_E _*_s_t_r_e_a_m)

     _i_n_t
     ppuuttcc(_i_n_t _c, _F_I_L_E _*_s_t_r_e_a_m)

     _i_n_t
     ppuuttcchhaarr(_i_n_t _c)

     _i_n_t
     ppuuttww(_i_n_t _w, _F_I_L_E _*_s_t_r_e_a_m)

DDEESSCCRRIIPPTTIIOONN
     The ffppuuttcc() function writes the character _c (converted to an ``unsigned
     char'') to the output stream pointed to by _s_t_r_e_a_m.

     PPuuttcc() acts essentially identically to ffppuuttcc(), but is a macro that ex-
     pands in-line. It may evaluate _s_t_r_e_a_m more than once, so arguments given
     to ppuuttcc() should not be expressions with potential side effects.

     PPuuttcchhaarr() is identical to ppuuttcc() with an output stream of _s_t_d_o_u_t.

     The ppuuttww() function writes the specified _i_n_t to the named output _s_t_r_e_a_m.

RREETTUURRNN VVAALLUUEESS
     The functions, ffppuuttcc(), ppuuttcc() and ppuuttcchhaarr() return the character writ-
     ten.  If an error occurs, the value EOF is returned.  The ppuuttww() function
     returns 0 on success; EOF is returned if a write error occurs, or if an
     attempt is made to write a read-only stream.

SSEEEE AALLSSOO
     ferror(3),  fopen(3),  getc(3),  stdio(3)

SSTTAANNDDAARRDDSS
     The functions ffppuuttcc(), ppuuttcc(), and ppuuttcchhaarr(), conform to ANSI C3.159-1989
     (``ANSI C''). A function ppuuttww() function appeared in Version 6 AT&T UNIX.

BBUUGGSS
     The size and byte order of an _i_n_t varies from one machine to another, and
     ppuuttww() is not recommended for portable applications.

BSD Experimental                 June 29, 1991                               1















