str(3G)                          UNIX System V                          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);

SEE ALSO
      string(3C).

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










10/89                                                                    Page 1