VMS Help
RTL Routines, STR$, STR$FIND_FIRST_IN_SET

 *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Find First Character in a Set of Characters routine searches
    a string, comparing each character to the characters in a
    specified set of characters. The string is searched character
    by character, from left to right. STR$FIND_FIRST_IN_SET returns
    the position of the first character in the string that matches
    any of the characters in the selected set of characters.

    Format

      STR$FIND_FIRST_IN_SET  source-string ,set-of-characters

  1 - Returns

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       write only
    mechanism:    by value

    Position in source-string where the first match is found; zero if
    no match is found.

    On Alpha systems, if the relative position of the substring can
    exceed 2**32-1, assign the return value to a quadword to ensure
    that you retrieve the correct relative position.

  2 - Arguments

 source-string

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    String that STR$FIND_FIRST_IN_SET compares to the set of
    characters, looking for the first match. The source-string
    argument is the address of a descriptor pointing to the character
    string.

 set-of-characters

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Set of characters that STR$FIND_FIRST_IN_SET is searching for
    in the string. The source-string argument is the address of a
    descriptor pointing to the set of characters.
  Close     HLB-list     TLB-list     Help  

[legal] [privacy] [GNU] [policy] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.