String Pattern-Matching Library Functions           strfind(3GEN)



NAME
     strfind, strrspn, strtrns, str - string manipulations

SYNOPSIS
     cc [ flag ... ] file ... -lgen [ library ... ]
     #include 

     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; other-
     wise, 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  RENTRANT
     flag  must be defined on the compile line.  This flag should
     only be used in multithreaded 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 = '\0';
       /* transform lower case to upper case */
       a1[] = "abcdefghijklmnopqrstuvwxyz";
       a2[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";



SunOS 5.11          Last change: 20 Jan 1999                    1






String Pattern-Matching Library Functions           strfind(3GEN)



       s2 = strtrns(s1, a1, a2, s2);



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     string(3C), attributes(5)




































SunOS 5.11          Last change: 20 Jan 1999                    2