COPYLIST(3G-SVR4)   RISC/os Reference Manual    COPYLIST(3G-SVR4)



NAME
     copylist - copy a file into memory

SYNOPSIS
     cc [flag ...] file ...  -lgen [library ...]

     #include <libgen.h>

     char *copylist (const char *filenm, offt *szptr);

DESCRIPTION
     copylist copies a list of items from a file into freshly
     allocated memory, replacing new-lines with null characters.
     It expects two arguments: a pointer filenm to the name of
     the file to be copied, and a pointer szptr to a variable
     where the size of the file will be stored.

     Upon success, copylist returns a pointer to the memory allo-
     cated.  Otherwise it returns NULL if it has trouble finding
     the file, calling malloc(3C), or opening the file.

EXAMPLES
     /* read "file" into buf */
     off_t size;
     char *buf;
     buf = copylist("file", &size);
     for (i = 0; i < size; i++)
          if(buf[i])
               putchar(buf[i]);
          else
               putchar('\n');

SEE ALSO
     malloc(3C).





















                        Printed 11/19/92                   Page 1