HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

copylist(3G) copylist(3G)

NAME

copylist() - copy a ﬁle into memory

SYNOPSIS

#include <libgen.h>

char *copylist(const char *

ﬁlenm, off_t *szptr);

DESCRIPTION

copylist copies a list of items from a ﬁle into freshly allocated memory, replacing new-lines with null

characters. It expects two arguments: a pointer ﬁlenm to the name of the ﬁle to be copied, and a pointer

szptr to a variable where the size of the ﬁle will be stored.

Upon success,

copylist returns a pointer to the memory allocated. Otherwise it returns NULL if it has

trouble ﬁnding the ﬁle, calling malloc

, or opening the ﬁle.

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’);