4D v19

collection.insert( )

Home

 
4D v19
collection.insert( )

collection.insert( )  


 

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 

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v19)
4D Programmiersprache ( 4D v19.1)