1PUTC(3) 386BSD Programmer's Manual PUTC(3) 2 3NNAAMMEE 4 ffppuuttcc, ppuuttcc, ppuuttcchhaarr, ppuuttww - output a character or word to a stream 5 6SSYYNNOOPPSSIISS 7 ##iinncclluuddee <<ssttddiioo..hh>> 8 9 _i_n_t 10 ffppuuttcc(_i_n_t _c, _F_I_L_E *_s_t_r_e_a_m) 11 12 _i_n_t 13 ppuuttcc(_i_n_t _c, _F_I_L_E *_s_t_r_e_a_m) 14 15 _i_n_t 16 ppuuttcchhaarr(_i_n_t _c) 17 18 _i_n_t 19 ppuuttww(_i_n_t _w, _F_I_L_E *_s_t_r_e_a_m) 20 21DDEESSCCRRIIPPTTIIOONN 22 The ffppuuttcc() function writes the character _c (converted to an ``unsigned 23 char'') to the output stream pointed to by _s_t_r_e_a_m. 24 25 PPuuttcc() acts essentially identically to ffppuuttcc(), but is a macro that 26 expands in-line. It may evaluate _s_t_r_e_a_m more than once, so arguments 27 given to ppuuttcc() should not be expressions with potential side effects. 28 29 PPuuttcchhaarr() is identical to ppuuttcc() with an output stream of _s_t_d_o_u_t. 30 31 The ppuuttww() function writes the specified _i_n_t to the named output _s_t_r_e_a_m. 32 33RREETTUURRNN VVAALLUUEESS 34 The functions, ffppuuttcc(), ppuuttcc() and ppuuttcchhaarr() return the character 35 written. If an error occurs, the value EOF is returned. The ppuuttww() 36 function returns 0 on success; EOF is returned if a write error occurs, 37 or if an attempt is made to write a read-only stream. 38 39SSEEEE AALLSSOO 40 ferror(3), fopen(3), getc(3), stdio(3) 41 42SSTTAANNDDAARRDDSS 43 The functions ffppuuttcc(), ppuuttcc(), and ppuuttcchhaarr(), conform to ANSI C3.159-1989 44 (``ANSI C''). A function ppuuttww() function appeared in Version 6 AT&T UNIX. 45 46BBUUGGSS 47 The size and byte order of an _i_n_t varies from one machine to another, and 48 ppuuttww() is not recommended for portable applications. 49 50BSD Experimental June 29, 1991 1 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67