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).