Content-type: text/html Man page of copylist

copylist

Section: String Pattern-Matching Library Functions (3GEN)
Updated: 29 Dec 1996
Index Return to Main Contents
 

NAME

copylist - copy a file into memory  

SYNOPSIS

cc [ flag ... ] file ... -lgen [ library ... ]
#include <libgen.h>

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

DESCRIPTION

The copylist() function 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 reading the file.  

USAGE

The copylist() function has a transitional interface for 64-bit file offsets. See lf64(5).  

EXAMPLES

Example 1: Example of copylist() function.

/* read "file" into buf */
off_t size;
char *buf;
buf = copylist("file", &size);
if (buf) {
        for (i=0; i<size; i++)
                if (buf[i])
                        putchar(buf[i]);
                else
                        putchar('\n');
        }
} else {
        fprintf(stderr, "%s: Copy failed for "file".\n", argv[0]);
        exit (1);
}

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

 

SEE ALSO

malloc(3C), attributes(5), lf64(5)  

NOTES

When compiling multithreaded applications, the _REENTRANT flag must be defined on the compile line. This flag should only be used in multithreaded applications.


 

Index

NAME
SYNOPSIS
DESCRIPTION
USAGE
EXAMPLES
ATTRIBUTES
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 02:39:53 GMT, October 02, 2010