copylist(3G)                                                   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 argu-
     ments: 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 allocated.
     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).






















Page 1                       Reliant UNIX 5.44                Printed 11/98