home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gnu / ixemul-39.47-env-bin.lha / man / cat3 / fread.0 < prev    next >
Text File  |  1993-12-07  |  2KB  |  67 lines
  1.  
  2. FREAD(3)                   UNIX Programmer's Manual                   FREAD(3)
  3.  
  4. NNAAMMEE
  5.      ffrreeaadd, ffwwrriittee - binary stream input/output
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.  
  10.      _i_n_t
  11.      ffrreeaadd(_v_o_i_d _*_p_t_r, _s_i_z_e___t _s_i_z_e, _s_i_z_e___t _n_m_e_m_b, _F_I_L_E _*_s_t_r_e_a_m)
  12.  
  13.      _i_n_t
  14.      ffwwrriittee(_v_o_i_d _*_p_t_r, _s_i_z_e___t _s_i_z_e, _s_i_z_e___t _n_m_e_m_b, _F_I_L_E _*_s_t_r_e_a_m)
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      The function ffrreeaadd() reads _n_m_e_m_b elements of data, each size bytes long,
  18.      from the stream pointed to by _s_t_r_e_a_m, storing them at the location given
  19.      by _p_t_r.
  20.  
  21.      The function ffwwrriittee() writes _n_m_e_m_b elements of data, each _s_i_z_e bytes
  22.      long, to the stream pointed to by _s_t_r_e_a_m, obtaining them from the loca­
  23.      tion given by _p_t_r.
  24.  
  25. RREETTUURRNN VVAALLUUEESS
  26.      The functions ffrreeaadd() and ffwwrriittee() advance the file position indicator
  27.      for the stream by the number of characters successfully read or written
  28.      and return that number.  If an error occurs, or the end­of­file is
  29.      reached, the return value is a short character count (or zero).
  30.  
  31.      The function ffrreeaadd() does not distinguish between end­of­file and error,
  32.      and callers must use feof(3) and ferror(3) to determine which occurred.
  33.  
  34. SSEEEE AALLSSOO
  35.      read(2),  write(2)
  36.  
  37. SSTTAANNDDAARRDDSS
  38.      The functions ffrreeaadd() and ffwwrriittee() conform to ANSI C3.159­1989 (``ANSI
  39.      C'').
  40.  
  41. BSD Experimental                 June 29, 1991                               1
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.