SysUtils.WideCompareStr Function

Compares Unicode strings based on the current locale with case sensitivity.

Pascal

function WideCompareStr(const S1: WideString; const S2: WideString): Integer;

C++

int WideCompareStr(const BSTR S1, const BSTR S2);

File

SysUtils

Description

WideCompareStr compares S1 to S2, with case sensitivity. The compare operation is controlled by the current locale. The return value is:

Condition	Return Value
S1 > S2	> 0
S1 < S2	< 0
S1 = S2	= 0

Note: Most locales consider lowercase characters to be less than the corresponding uppercase characters. This is in contrast to ASCII order, in which lowercase characters are greater than uppercase characters. with S1 set to 'a' and S2 set to 'A', WideCompareStr returns a value lsess than zero, while CompareStr returns a value greater than zero.