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.
APPLICATION USAGE
copylist
is thread-safe. It is not async-cancel-safe. A cancellation
point may occur when a thread is executing copylist.
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');
