String Pattern-Matching Library Functions          copylist(3GEN)



NAME
     copylist - copy a file into memory

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

     char *copylist(const char *filenm, offt *szptr);


DESCRIPTION
     The copylist() function 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  NUL  if it has trouble
     finding the file, calling malloc(), or reading the file.

USAGE
     The copylist() function has  a  transitional  interface  for
     64-bit file offsets. See lf64(5).

EXAMPLES
     Example 1 Example of copylist() function.

       /* read "file" into buf */
       offt size;
       char *buf;
       buf = copylist("file", &size);
       if (buf) {
            for (i=0; i