SysUtils.AnsiStrLIComp
From RAD Studio VCL Reference
Contents |
Delphi Information
From SysUtils.pas
function AnsiStrLIComp(S1: PAnsiChar; S2: PAnsiChar; MaxLen: Cardinal): Integer; overload; function AnsiStrLIComp(S1: PWideChar; S2: PWideChar; MaxLen: Cardinal): Integer; overload;
Unit: SysUtils
Type: function
Visibility: public
C++ Information
From SysUtils.hpp
int __fastcall AnsiStrLIComp(char * S1, char * S2, unsigned int MaxLen);
Unit: SysUtils
Type: function
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.