TCollection.FirstThat

Return first item which matches a test.

Declaration

Source position: objects.pp line 442

default 
  function FirstThat(Test: TCallbackFunBoolParam) : Pointer;

Description

This function returns the first item in the collection for which Test returns a non-nil result. Test is a function that accepts 1 argument: a pointer to an object, and that returns a pointer as a result.

Errors

None.

See also

Name Description
TCollection.LastThat Return last item which matches a test.

Example

Program ex21;
{ Program to demonstrate the TCollection.FirstThat method }
Uses Objects,MyObject; { For TMyObject definition and registration }
Var C : PCollection;
    M : PMyObject;
    I : Longint;
Function CheckField (Dummy: Pointer;P : PMyObject) : Longint;
begin
  If P^.GetField>56 then
    Checkfield:=1
  else
    CheckField:=0;
end;
begin
  C:=New(PCollection,Init(100,10));
  For I:=1 to 100 do
    begin
    M:=New(PMyObject,Init);
    M^.SetField(I);
    C^.Insert(M);
    end;
  Writeln ('Inserted ',C^.Count,' objects');
  Writeln ('first one for which Field>56  has index (should be 56) : ',
            C^.IndexOf(C^.FirstThat(@CheckField)));
  C^.FreeAll;
  Dispose(C,Done);
end.