[Overview][Constants][Types][Classes][Procedures and functions][Index] | Reference for unit 'Contnrs' (#fcl)

# TFPObjectList

[Properties (by Name)] [Methods (by Name)] [Events (by Name)]

TFPList descendent which manages objects.

## Declaration

Source position: contnrs.pp line 31

`type TFPObjectList = class(TObject)`
`public`
`constructor Create();` |  | Create a new object list
`destructor Destroy; override;` |  | Clears the list and destroys the list instance
`procedure Clear;` |  | Clear all elements in the list.
`function Add();` |  | Add an object to the list.
`procedure Delete();` |  | Delete an element from the list.
`procedure Exchange();` |  | Exchange the location of two objects
`function Expand;` |  | Expand the capacity of the list.
`function Extract();` |  | Extract an object from the list
`function Remove();` |  | Remove an item from the list.
`function IndexOf();` |  | Search for an object in the list
`function FindInstanceOf();` |  | Search for an instance of a certain class
`procedure Insert();` |  | Insert a new object in the list
`function First;` |  | Return the first non-nil object in the list
`function Last;` |  | Return the last non-nil object in the list.
`procedure Move();` |  | Move an object to another location in the list.
`procedure Assign();` |  | Copy the contents of a list.
`procedure Pack;` |  | Remove all Nil references from the list
`procedure Sort();` |  | Sort the list of objects
`procedure ForEachCall();` |  | For each object in the list, call a method or procedure, passing it the object.
`property Capacity: Integer; [rw]` |  | Capacity of the list
`property Count: Integer; [rw]` |  | Number of elements in the list.
`property OwnsObjects: Boolean; [rw]` |  | Should the list free elements when they are removed.
`property Items []: TObject; default; [rw]` |  | Indexed access to the elements of the list.
`property List: TFPList; [r]` |  | Internal list used to keep the objects.
`end;`

## Inheritance

`TFPObjectList` |  | TFPList descendent which manages objects.
`TObject`

## Description

TFPObjectList is a TFPList based list which has as the default array property TObjects instead of pointers. By default it also manages the objects: when an object is deleted or removed from the list, it is automatically freed. This behaviour can be disabled when the list is created.

In difference with TObjectList, TFPObjectList offers no notification mechanism of list operations, allowing it to be faster than TObjectList. For the same reason, it is also not a descendent of TFPList (although it uses one internally).

## See also

#rtl.classes.TFPList
TObjectList |  | List to manage object instances.

Documentation generated on: May 14 2021