PUTC(3) BSD Programmer's Manual PUTC(3) NNAAMMEE ffppuuttcc, ppuuttcc, ppuuttcchhaarr, ppuuttww - output a character or word to a stream SSYYNNOOPPSSIISS ##iinncclluuddee <<ssttddiioo..hh>> _i_n_t ffppuuttcc(_i_n_t _c, _F_I_L_E _*_s_t_r_e_a_m); _i_n_t ppuuttcc(_i_n_t _c, _F_I_L_E _*_s_t_r_e_a_m); _i_n_t ppuuttcchhaarr(_i_n_t _c); _i_n_t ppuuttww(_i_n_t _w, _F_I_L_E _*_s_t_r_e_a_m); DDEESSCCRRIIPPTTIIOONN The ffppuuttcc() function writes the character _c (converted to an ``unsigned char'') to the output stream pointed to by _s_t_r_e_a_m. PPuuttcc() acts essentially identically to ffppuuttcc(), 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 ppuuttcc() should not be expressions with potential side effects. PPuuttcchhaarr() is identical to ppuuttcc() with an output stream of _s_t_d_o_u_t. The ppuuttww() function writes the specified _i_n_t to the named output _s_t_r_e_a_m. RREETTUURRNN VVAALLUUEESS The functions, ffppuuttcc(), ppuuttcc() and ppuuttcchhaarr() return the character writ- ten. If an error occurs, the value EOF is returned. The ppuuttww() 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. SSEEEE AALLSSOO ferror(3), fopen(3), getc(3), stdio(3) SSTTAANNDDAARRDDSS The functions ffppuuttcc(), ppuuttcc(), and ppuuttcchhaarr(), conform to ANSI C X3.159-1989 (``ANSI C ''). A function ppuuttww() function appeared in Version 6 AT&T UNIX. BBUUGGSS The size and byte order of an _i_n_t varies from one machine to another, and ppuuttww() is not recommended for portable applications. 4.4BSD June 4, 1993 1