copylist.3g (2010 09)

c
copylist(3G) copylist(3G)
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:
cc foo.c -lgen
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), thread_safety(5).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1