RAD Studio VCL Reference
SysUtils.AnsiStrLComp Function

Compares the first MaxLen bytes of two null-terminated strings, case-sensitively.

function AnsiStrLComp(S1: PAnsiChar; S2: PAnsiChar; MaxLen: Cardinal): Integer; overload;
function AnsiStrLComp(S1: PWideChar; S2: PWideChar; MaxLen: Cardinal): Integer;
int AnsiStrLComp(PAnsiChar S1, PAnsiChar S2, unsigned MaxLen);
int AnsiStrLComp(PWideChar S1, PWideChar S2, unsigned MaxLen);

AnsiStrLComp compares S1 to S2, with case sensitivity. If S1 or S2 is longer than MaxLen bytes, AnsiStrLComp only compares the first MaxLen bytes. The compare operation is controlled by the current locale. The return value is:

Return Value 
S1 > S2  
> 0  
S1 < S2  
< 0  
S1 = S2 (up to MaxLen characters)  
= 0  

Note: This function supports multi-byte character sets (MBCS).
Note: AnsiStrLComp can continue the comparison beyond a null terminating character if S1 and S2 are equal up to a null character and the null character occurs before MaxLen bytes.
Note: Most locales consider lowercase characters to come before corresponding uppercase characters. This is in contrast to ASCII order, in which lowercase characters come after uppercase characters.

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!