copylist(S)

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(S) malloc(S)

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(S).

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