System.Classes.TList.Insert
Delphi
procedure Insert(Index: Integer; Item: Pointer);
C++
void __fastcall Insert(int Index, void * Item);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TList |
Beschreibung
Fügt dem Array Items an der mit Index bezeichneten Position ein Objekt hinzu.
Mit Insert wird der Zeiger Item an beliebiger Stelle im Array Items eingefügt. Die Indexnumerierung beginnt bei Null, sodass die erste Array-Position den Index 0 hat. Das Element, das vorher an der Stelle des eingefügten stand, erhält zusammen mit allen nachfolgenden Elementen eine um eins höhere Indexposition. Insert inkrementiert den Wert der Eigenschaft Count und weist bei Bedarf Speicher zu, indem der Wert von Capacity entsprechend erhöht wird.
Wenn ein nil- (Delphi) bzw. NULL- (C++) Zeiger durch ein neues Element ersetzt werden soll, ohne das Array zu vergrößern, setzen Sie die Eigenschaft Items.