2.5.4.101 StrSameEx

  • Article

The StrSameEx function determines whether two text strings are the same.

ABNF:

 StrSameEx = val val val val " STRSAMEEX():128"

Required Arguments:

Name: FirstText

Type: vString

An argument that specifies the first string to be compared.

Name: SecondText

Type: vString

An argument that specifies the second string to be compared.

Name: Locale

Type:  vLanguageID

An argument that specifies the LCID of the culture used by the string comparison, according to .Net globalization rules. A value of zero specifies the invariant culture. For more information about .NET globalization rules, see [MSDN-ENCLOC].

Name: Flag

Type: vSignedLong

An argument that specifies additional rules to be used in the comparison. The value is a combination of values from the following table. The rules given in the following table correspond to members of the .NET CompareOptions enumeration, as described in [MSDN-CompareOptions].

Value

Meaning

0x00

No additional rules apply.

0x01

Ignore case.

0x10

Ignore non-spacing combining characters.

0x100

Ignore symbols.

0x1000

All non-alphanumeric characters come before all alphanumeric characters.

0x10000

Ignore differences between hiragana and katakana characters that represent the same phonetic sound.

0x20000

Ignore character width, or differences between the single-byte and double-byte representations of the same character.

Return Value:

Type: PtgBool

This function returns a PtgBool containing TRUE if the strings are the same and FALSE otherwise. If the Locale or Flag arguments are invalid, this function returns a PtgBool containing a value of FALSE.