HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
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.
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’);
SEE ALSO
malloc(3C).
Section 3−−82 − 1 − HP-UX Release 11i: December 2000
___
___