str(3G)                                                             str(3G)

NAME
     str: strfind, strrspn, strtrns - amend strings

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. new is returned as the result.

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);

RESULT
     If the second string is not a substring of the first string strfind()
     returns -1.

SEE ALSO
     string(3C).









Page 1                       Reliant UNIX 5.44                Printed 11/98