copylist(3gen) [opensolaris man page]

copylist(3GEN)					     String Pattern-Matching Library Functions					    copylist(3GEN)

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('
');
	      }
	 } else {
	      fprintf(stderr, "%s: Copy failed for "file".
", argv[0]);
	      exit(1);
	 }

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-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  mul-
       tithreaded applications.

SunOS 5.11							    29 Dec 1996 						    copylist(3GEN)

strfind(3GEN)					     String Pattern-Matching Library Functions					     strfind(3GEN)

NAME

       strfind, strrspn, strtrns, str - string manipulations

SYNOPSIS

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

       int strfind(const char *as1, const char *as2);

       char *strrspn(const char *string, const char *tc);

       char * strtrns(const char *string, const char *old, const char *new, char *result);

DESCRIPTION

       The  strfind()  function  returns the offset of the first occurrence of the second string,  as2, if it is a substring of string as1. If the
       second string is not a substring of the first string strfind() returns  -1.

       The strrspn() function trims chartacters from a string. It searches from the end of string for the first character that is not contained in
       tc. If such a character is found, strrspn() returns a pointer to the next character; otherwise, it returns a pointer to string.

	The  strtrns()	function transforms  string and copies it into	result. Any character  that appears in	old is replaced with the character
       in the same position in	new. The  new result is returned.

USAGE

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

EXAMPLES

       Example 1: An example of the strfind() function.

       /* find offset to substring "hello" within as1 */
       i = strfind(as1, "hello");
       /* trim junk from end of string */
       s2 = strrspn(s1, "*?#$%");
       *s2 = '';
       /* transform lower case to upper case */
       a1[] = "abcdefghijklmnopqrstuvwxyz";
       a2[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
       s2 = strtrns(s1, a1, a2, s2);

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       string(3C), attributes(5)

SunOS 5.10							    20 Jan 1999 						     strfind(3GEN)