Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
4D v19.8
collection.insert( )

collection.insert( ) 


 

collection.insert ( Index ; Element ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Index  Lange Ganzzahl in Stelle zum Einfügen des Elements
Element  Ausdruck in Element zum Einfügen in die Collection
Funktionsergebnis  Collection in Ursprüngliche Collection mit eingefügtem Element

Die Funktion collection.insert( ) fügt Element an der angegebenen Position Index in der Collection Instanz ein und gibt die bearbeitete Collection zurück.

Hinweis: Diese Funktion ändert die ursprüngliche Collection.

In Index übergeben Sie die Position, an der das Element in die Collection eingefügt werden soll.

Warnung: Beachten Sie, dass Elemente der Collection ab 0 gezählt werden.

  • Ist index > Länge der Collection, wird der Startindex auf die Länge der Collection gesetzt.
  • Ist index < 0, wird er neu berechnet als Index:=index+length (wird als Versatz vom Ende der Collection gewertet).
  • Ist der berechnete Wert negativ, wird Index auf 0 gesetzt.

Die Collection akzeptiert zum Einfügen jede Art von Element, selbst eine andere Collection ist möglich.

 C_COLLECTION($col)
 $col:=New collection("a";"b";"c";"d") //$col=["a","b","c","d"]
 $col.insert(2;"X") //$col=["a","b","X","c","d"]
 $col.insert(-2;"Y") //$col=["a","b","X","Y","c","d"]
 $col.insert(-10;"Hi") //$col=["Hi","a","b","X","Y","c","d"]



Siehe auch 

collection.combine( )

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Collections

 
SEITENINHALT 
 
GESCHICHTE 

Erstellt: 4D v16 R6

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v19)
4D Programmiersprache ( 4D v19.1)
4D Programmiersprache ( 4D v19.4)
4D Programmiersprache ( 4D v19.5)
4D Programmiersprache ( 4D v19.6)
4D Programmiersprache ( 4D v19.7)
4D Programmiersprache ( 4D v19.8)