collection.remove( )

Home

4D v19.8


collection.remove ( Index {; Wieviele} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Index	Lange Ganzzahl	Element, bei dem das Entfernen startet
Wieviele	Lange Ganzzahl	Anzahl Elemente zum Entfernen, ohne Angabe 1 Element
Funktionsergebnis	Collection	Collection ohne entfernte Elemente

Beschreibung

Die Funktion collection.remove( ) entfernt ein oder mehrere Elemente aus der angegebenen Position Index in der Collection und gibt die bearbeitete
Collection zurück.

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

In Index übergeben Sie die Position, an der Elemente aus der Collection entfernt werden sollen. Warnung: Beachten Sie, dass Elemente der Collection ab 0 gezählt werden. Ist Index größer als die Länge der Collection, wird der aktuelle Startindex auf die Länge der Collection gesetzt.

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

In Wieviele übergeben Sie die Anzahl der zu entfernenden Elemente aus Index. Ist Wieviele nicht angegeben, wird ein Element entfernt.

Versuchen Sie, aus einer leeren Collection Elemente zu entfernen, führt die Funktion nichts aus. Es wird kein Fehler generiert.

Beispiel

 C_COLLECTION($col)

 $col:=New collection("a";"b";"c";"d";"e";"f";"g";"h")

 $col.remove(3) // $col=["a","b","c","e","f","g","h"]

 $col.remove(3;2) // $col=["a","b","c","g","h"]

 $col.remove(-8;1) // $col=["b","c","g","h"]

 $col.remove(-3;1) // $col=["b","g","h"]

Siehe auch

collection.clear( )