[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'Objects' (#rtl)

# TCollection.ForEach

Execute procedure for each item in the list.

## Declaration

Source position: objects.pp line 426

`procedure TCollection.ForEach(`
`Action: CodePointer`
`);`

## Description

ForEach calls Action for each element in the collection, and passes the element as an argument to Action.

Action is a procedural type variable that accepts a pointer as an argument.

## Errors

None.

## See also

TCollection.FirstThat |  | Return first item which matches a test.
TCollection.LastThat |  | Return last item which matches a test.

## Example

    Program ex21;

    { Program to demonstrate the TCollection.Foreach method }

    Uses Objects,MyObject; { For TMyObject definition and registration }

    Var C : PCollection;
        M : PMyObject;
        I : Longint;

    Procedure PrintField (Dummy: Pointer;P : PMyObject);

    begin
      Writeln ('Field : ',P^.GetField);
    end;

    begin
      C:=New(PCollection,Init(100,10));
      For I:=1 to 100 do
        begin
        M:=New(PMyObject,Init);
        M^.SetField(100-I);
        C^.Insert(M);
        end;
      Writeln ('Inserted ',C^.Count,' objects');
      C^.ForEach(@PrintField);
      C^.FreeAll;
      Dispose(C,Done);
    end.