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');
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 01 June 2005