HELPLIB.HLB  —  RTL Routines, STR$  STR$COMPARE_MULTI
    The Compare Two Strings for Equality Using Multinational
    Character Set routine compares two character strings for equality
    using the DEC Multinational Character Set.

    Format

      STR$COMPARE_MULTI  first-source-string ,second-source-string

                         [,flags-value] [,foreign-language]

1  –  Returns

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

    The values returned by STR$COMPARE_MULTI and the conditions to
    which they translate are as follows:

    Returned
    Value         Condition

                  first-source-string is less than second-source-
                  string.
    0             Both strings are the same; the shorter string is
                  blank filled.
    1             first-source-string is greater than second-source-
                  string.

2  –  Arguments

 first-source-string

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

    First string in the comparison. The first-source-string argument
    is the address of a descriptor pointing to the first string.

 second-source-string

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

    Second string in the comparison. The second-source-string
    argument is the address of a descriptor pointing to the second
    string.

 flags-value

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value

    A single flag bit. The flags-value argument is a signed longword
    integer that contains this flag bit. The flags-value argument
    indicates whether the comparison is to be case sensitive or case
    blind. The default value of flags-value is 0, indicating a case
    sensitive comparison. The following table lists the meaning of
    the bit values:

    Value Meaning

    0     Uppercase and lowercase characters are not equivalent. (The
          comparison is case sensitive.)
    1     Uppercase and lowercase characters are equivalent. (The
          comparison is case blind.)

 foreign-language

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value

    Indicator that determines the foreign language table to be
    used. The foreign-language argument is an unsigned longword that
    contains this foreign language table indicator. The default value
    of foreign-language is 1. The following table lists the value
    of the foreign-language argument associated with each language
    table:

    Value Language

    1     Multinational table
    2     Danish table
    3     Finnish/Swedish table
    4     German table
    5     Norwegian table
    6     Spanish table
Close Help