System.Classes.TList.Add

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Add(Item: Pointer): Integer;

C++

int __fastcall Add(void * Item);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Classes.pas
System.Classes.hpp
System.Classes TList

Beschreibung

Fügt am Ende der Liste ein neues Element an.

Mit Add wird am Ende des Arrays Items ein neues Element angefügt. Add liefert den Index des neuen Elements zurück, wobei das erste Element den Index 0 hat.

Add inkrementiert den Wert der Eigenschaft Count und weist bei Bedarf Speicher zu, indem der Wert von Capacity entsprechend erhöht wird.

Anmerkung:  Ein mit Add angefügter Zeiger gelangt immer an das Ende des Arrays, selbst wenn das Array nil- (Delphi) bzw. NULL- (C++) Zeiger enthält.

Siehe auch

Codebeispiele