System.SysUtils.AnsiStrLIComp

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function AnsiStrLIComp(S1, S2: PAnsiChar; MaxLen: Cardinal): Integer;
function AnsiStrLIComp(S1, S2: PWideChar; MaxLen: Cardinal): Integer;

C++

extern DELPHI_PACKAGE int __fastcall AnsiStrLIComp _DEPRECATED_ATTRIBUTE1("Moved to the AnsiStrings unit") (char * S1, char * S2, unsigned MaxLen)/* overload */;

Properties

Type Visibility Source Unit Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Description

Warning: The ANSI version of AnsiStrLIComp is deprecated. Please use the AnsiStrings unit.

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.

See Also