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
         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 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).



















   7/91                                                                 Page 1