System.AnsiStrings.AnsiStrLIComp
Delphi
function AnsiStrLIComp(S1, S2: PAnsiChar; MaxLen: Cardinal): Integer;
C++
extern DELPHI_PACKAGE int __fastcall AnsiStrLIComp(char * S1, char * S2, unsigned MaxLen)/* overload */;
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
function | public | System.AnsiStrings.pas System.AnsiStrings.hpp |
System.AnsiStrings | System.AnsiStrings |
Description
Compares two strings, case-insensitively, up to the first MaxLen bytes.
AnsiStrLIComp compares S1 to S2, without case sensitivity. If S1 or S2 is longer than MaxLen characters, AnsiStrLIComp only compares up to the first MaxLen characters. The comparison operation is controlled by the current locale. The return value is one of the following.
Condition | 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: AnsiStrLIComp 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.