NAME
copylist() — copy a file into memory
SYNOPSIS
#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.
To use this interface, link in the libgen library by specifying
-lgen.
For example:
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');