copylist(3G)                     UNIX System V                     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).





















10/89                                                                    Page 1