FREAD(S)                 XENIX System V                  FREAD(S)



     Name
          fread, fwrite - Performs buffered binary input and output.

     Syntax
          #include <stdio.h>

          int fread (ptr, size, nitems, stream)
          char *ptr;
          int size, nitems;
          FILE *stream;

          int fwrite (ptr, size, nitems, stream)
          char *ptr;
          int size, nitems;
          FILE *stream;

     Description
          fread reads, into a block beginning at ptr, nitems of data
          of the type of *ptr from the named input stream, where an
          item of data is a sequence of bytes (not necessarily
          terminated by a null byte) of length size.  fread stops
          appending bytes if an end-of-file or error condition is
          encountered while reading stream, or if nitems items have
          been read. fread leaves the file pointer in stream, if
          defined, pointing to the byte following the last byte read,
          if there is one.  fread does not change the contents of
          stream.  It returns the number of items actually read.

          fwrite appends at most nitems of data of the type of *ptr
          beginning at ptr to the named output stream.  fwrite stops
          appending when it has appended nitems items of data or if an
          error condition is encountered on stream.  fwrite does not
          change the contents of the array pointed to by ptr.  fwrite
          increments the file pointer in stream, if defined, by the
          number of bytes written.  It returns the number of items
          actually written.

     See Also
          fopen(S), getc(S), gets(S), printf(S), putc(S), puts(S),
          read(S), scanf(S), write(S)

     Diagnostics
          fread and fwrite return the number of items read or written.
          If sizeof or nitems is non-positive, no characters are read
          or written and 0 is returned by both fread and fwrite.










     Page 1                                           (printed 8/7/87)