FREAD(3S)                DOMAIN/IX SYS5                 FREAD(3S)



NAME
     fread, fwrite - binary input/output on files

USAGE
     #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 copies, into an array pointed to by ptr, nitems items
     of data from the named input stream.  An item of data is a
     sequence of bytes (not necessarily terminated by a null
     byte) of length size.  Fread stops appending bytes if it
     encounters an end-of-file or an error condition while read-
     ing stream, or if it has already read nitems.  Fread leaves
     the file pointer, if defined, in stream, pointing to the
     byte following the last byte read, if there is one.  Fread
     does not change the contents of stream.

     Fwrite appends a maximum of nitems items of data from the
     array pointed to by ptr to the named output stream.  Fwrite
     stops when it has appended nitems items of data, or if if it
     encounters an error condition on stream.  Fwrite does not
     change the contents of the array pointed to by ptr.

     The argument size is typically sizeof(*ptr) where the
     pseudo-function sizeof specifies the length of an item
     pointed to by ptr.  If ptr points to a data type other than
     char, it should be cast into a pointer to char.

DIAGNOSTICS
     Fread and fwrite return the number of items read or written.
     If size or nitems is non-positive, no characters are read or
     written and zero is returned by both fread and fwrite.

RELATED INFORMATION
     read(2), write(2), fopen(3S), getc(3S), gets(3S),
     printf(3S), putc(3S), puts(3S), scanf(3S).






Printed 12/4/86                                           FREAD-1