str(3G)                                                             str(3G)


   NAME
         str: strfind, strrspn, strtrns - 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 *str, const char *old, const char *new,
               char *result);

   DESCRIPTION
         strfind returns the offset of the second string, as2, if it is a
         substring of string as1.

         strrspn returns a pointer to the first character in the string to be
         trimmed (all characters from the first character to the end of string
         are in tc).

         strtrns transforms str 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.

   EXAMPLES
         /* find pointer to substring "hello" in 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";
         s2 = strtrns(s1, a1, a2, s2);

   DIAGNOSTICS
         If the second string is not a substring of the first string strfind
         returns -1.

   SEE ALSO
         string(3C).











   7/91                                                                 Page 1