4.4BSD/usr/share/man/cat3/fwrite.0

FREAD(3)                    BSD Programmer's Manual                   FREAD(3)

NNAAMMEE
     ffrreeaadd, ffwwrriittee - binary stream input/output

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssttddiioo..hh>>

     _i_n_t
     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);

     _i_n_t
     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);

DDEESSCCRRIIPPTTIIOONN
     The function ffrreeaadd() reads _n_m_e_m_b objects, each size bytes long, from the
     stream pointed to by _s_t_r_e_a_m, storing them at the location given by _p_t_r.

     The function ffwwrriittee() writes _n_m_e_m_b objects, each _s_i_z_e bytes long, to the
     stream pointed to by _s_t_r_e_a_m, obtaining them from the location given by
     _p_t_r.

RREETTUURRNN VVAALLUUEESS
     The functions ffrreeaadd() and ffwwrriittee() advance the file position indicator
     for the stream by the number of bytes read or written.  They return the
     number of objects read or written.  If an error occurs, or the end-of-
     file is reached, the return value is a short object count (or zero).

     The function ffrreeaadd() does not distinguish between end-of-file and error,
     and callers must use feof(3) and ferror(3) to determine which occurred.
     The function ffwwrriittee() returns a value less than _n_m_e_m_b only if a write er-
     ror has occurred.

SSEEEE AALLSSOO
     read(2),  write(2)

SSTTAANNDDAARRDDSS
     The functions ffrreeaadd() and ffwwrriittee() conform to ANSI C X3.159-1989 (``ANSI
     C '').

4.4BSD                           June 4, 1993                                1