TList.Capacity property
Current capacity (i.e. number of pointers that can be stored) of the list.
Declaration
property Capacity: Integer read GetCapacity write SetCapacity;Description
Capacity contains the number of pointers the list can store
before it starts to grow.
If a new pointer is added to the list using add or insert, and there is not enough memory to store the new pointer, then the list will try to allocate more memory to store the new pointer. Since this is a time consuming operation, it is important that this operation be performed as little as possible. If it is known how many pointers there will be before filling the list, it is a good idea to set the capacity first before filling. This ensures that the list doesn't need to grow, and will speed up filling the list.
See also
An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.