Sign in Join
FPDoc Onlineexperiment

stricomp function

In unit Strings

Compare 2 null-terminated strings, case insensitive.

Declaration

pascal
function stricomp(str1: PAnsiChar; str2: PAnsiChar): SizeInt

Description

Compares the null-terminated strings S1 and S2, ignoring case. The result is

  • A negative SizeInt when S1<S2.
  • 0 when S1=S2.
  • A positive SizeInt when S1>S2.

Errors

None.

See also

Example: ex8

pascal
Program Example8;

Uses strings;

{ Program to demonstrate the StrLComp function. }

Const P1 : PChar = 'This is the first string.';
      P2 : PCHar = 'This is the second string.';

Var L : Longint;

begin
  Write ('P1 and P2 are ');
  If StrComp (P1,P2)<>0 then write ('NOT ');
  write ('equal. The first ');
  L:=1;
  While StrLComp(P1,P2,L)=0 do inc (L);
  dec(l);
  Writeln (l,' characters are the same.');
end.

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.