copylist(3G)							  copylist(3G)

NAME    [Toc]    [Back]

     copylist -	copy a file into memory

SYNOPSIS    [Toc]    [Back]

     cc	[flag ...] file	...  -lgen [library ...]

     #include <libgen.h>

     char *copylist (const char	*filenm<b>, off_t *szptr<b>);

DESCRIPTION    [Toc]    [Back]

     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.

EXAMPLES    [Toc]    [Back]

     /*	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    [Toc]    [Back]

     malloc(3C)


									PPPPaaaaggggeeee 1111