Skip to content

    CompareText

    Compare 2 ansistrings case insensitive.

    Declaration

    Source position: sysstrh.inc line 84

    function CompareText(const S1: string; const S2: string) : Integer
                    ;  overload; overload;

    function CompareText(const S1: string; const S2: string; 
                    LocaleOptions: TLocaleOptions) : Integer;  overload; overload;

    Description

    CompareText compares two strings, S1 and S2, and returns the following result:

    <0
    if S1<S2.
    0
    if S1=S2.
    >0
    if S1>S2.

    The comparison of the two strings is case-insensitive. The function does not take internationalization settings into account, it simply compares ASCII values.

    Errors

    None.

    See also

    Name Description
    AnsiCompareText Compare 2 ansistrings, case insensitive, using locale settings.
    AnsiCompareStr Compare 2 ansistrings, case sensitive, using locale settings.
    CompareStr Compare 2 ansistrings case-sensitively, ignoring special characters.

    Example

    Program Example66;

{ This program demonstrates the CompareText function }
{$H+}

Uses sysutils;

Procedure TestIt (S1,S2 : String);

Var R : Longint;

begin
  R:=CompareText(S1,S2);
  Write ('"',S1,'" is ');
  If R<0 then
    write ('less than ')
  else If R=0 then
    Write ('equal to ')
  else
    Write ('larger than ');
  Writeln ('"',S2,'"');
end;

Begin
  Testit('One string','One smaller string');
  Testit('One string','one string');
  Testit('One string','One string');
  Testit('One string','One tall string');
End.