SysUtils.AnsiCompareStr Function

Compares strings based on the current locale with case sensitivity.

Pascal

function AnsiCompareStr(const S1: string; const S2: string): Integer;

C++

int AnsiCompareStr(const AnsiString S1, const AnsiString S2);

File

SysUtils

Description

AnsiCompareStr 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. Thus, setting S1 to 'a' and S2 to 'A' causees AnsiCompareStr to return a value less than zero, while CompareStr, with the same arguments, returns a value greater than zero.