copylist(3G)

NAME
     copylist - copy a file into memory

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

     #include <libgen.h>

     char *copylist (const char *filenm, off_t *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 */
     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)