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, in bytes, 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). 

CX/UX Programmer’s Reference Manual