Skip to content

AnsiCompareStr

Compare 2 ansistrings, case sensitive, using locale settings.

Declaration

Source position: sysstrh.inc line 93

function AnsiCompareStr(const S1: string; const S2: string) : Integer;

Description

AnsiCompareStr compares two strings and returns the following result:

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

The comparison takes into account Ansi characters, i.e. it observes the locale. Contrary to AnsiCompareText, the comparison is case sensitive.

Remark:

A widestring manager must be installed in order for this function to work correctly with various character sets.

Errors

None.

See also

Name Description
AdjustLineBreaks Convert possible line-endings to the currently valid line ending.
AnsiCompareText Compare 2 ansistrings, case insensitive, using locale settings.

Example

Program Example49;

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

Uses sysutils;

Procedure TestIt (S1,S2 : String);

Var R : Longint;

begin
  R:=AnsiCompareStr(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.