copylist(3G)      MISC. REFERENCE MANUAL PAGES       copylist(3G)



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, or opening the file.

EXAMPLES
     /* read "file" into buf */
     offt 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).





















                                                                1