home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat3 / fflush.0 < prev    next >
Text File  |  1993-12-07  |  2KB  |  67 lines
  1.  
  2. FFLUSH(3)                  UNIX Programmer's Manual                  FFLUSH(3)
  3.  
  4. NNAAMMEE
  5.      fffflluusshh, ffppuurrggee - flush a stream
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.  
  10.      _i_n_t
  11.      fffflluusshh(_F_I_L_E _*_s_t_r_e_a_m)
  12.  
  13.      _i_n_t
  14.      ffppuurrggee(_F_I_L_E _*_s_t_r_e_a_m)
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      The function fffflluusshh() forces a write of all buffered data for the given
  18.      output or update _s_t_r_e_a_m via the stream's underlying write function.  The
  19.      open status of the stream is unaffected.
  20.  
  21.      If the _s_t_r_e_a_m argument is NULL, fffflluusshh() flushes _a_l_l open output streams.
  22.  
  23.      The function ffppuurrggee() erases any input or output buffered in the given
  24.      _s_t_r_e_a_m. For output streams this discards any unwritten output.  For input
  25.      streams this discards any input read from the underlying object but not
  26.      yet obtained via getc(3);  this includes any text pushed back via ungetc.
  27.  
  28.  
  29. RREETTUURRNN VVAALLUUEESS
  30.      Upon successful completion 0 is returned.  Otherwise, EOF is returned and
  31.      the global variable _e_r_r_n_o is set to indicate the error.
  32.  
  33. EERRRROORRSS
  34.      [EBADF]  _S_t_r_e_a_m is not an open stream, or, in the case of fffflluusshh(), not a
  35.               stream open for writing.
  36.  
  37.      The function fffflluusshh() may also fail and set _e_r_r_n_o for any of the errors
  38.      specified for the routine write(2).
  39.  
  40. SSEEEE AALLSSOO
  41.      write(2),  fopen(3),  fclose(3),  setbuf(3)
  42.  
  43. SSTTAANNDDAARRDDSS
  44.      The fffflluusshh() function conforms to ANSI C3.159­1989 (``ANSI C'').
  45.  
  46. BSD Experimental                 June 29, 1991                               1
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.