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