DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

copylist(3G)


copylist, copylist64 -- copy a file into memory

Synopsis

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

#include <libgen.h>

char *copylist(const char *filenm, off_t *szptr);

char *copylist64(const char *filenm, off64_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.

References

intro(2) malloc(3C)

Notices

Considerations for large file support

copylist64 supports large files, but is otherwise identical to copylist. For details on programming for large file capable applications, see ``Large File Support'' on intro(2).

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


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004