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.11							    20 Jan 1999 						     strfind(3GEN)