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, 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');

       REFERENCES
             malloc(3C)
















                           Copyright 1994 Novell, Inc.               Page 1