copylist(3G)                   DG/UX 5.4R3.00                   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).























Licensed material--property of copyright holder(s)                         1