Die Funktion l$remove erwartetet (wie alle l$*() Funktionen) als ersten Parameter eine Referenz auf eine (ggf. indizierte) Variable. Diese Variable wird identisch zu list() zwangsweise in eine Liste gewandelt, um anschließend modifiziert zu werden.

Der Inhalt der Variable list_var wird nicht auf den Stack kopiert. Stattdessen wird direkt und damit effizient auf den Inhalt der Variable zugegriffen.

pos1, pos2

Start- und Endposition innerhalb von list_var, die einen Bereich beschreiben, der aus der Liste entfernt werden soll.

pos1 und pos2 werden jeweils wie folgt normiert: Bei einem Wert <0 wird die Anzahl der Elemente der Liste list_var addiert. Ist der Wert nach der Addition weiterhin <0, dann wird der Wert Null verwendet. Damit sind Angaben relativ zum Ende der Liste möglich. Nach oben wird der Wert auf die Anzahl der Elemente der Liste list_var begrenzt.

Beschreibung:

Aus der Liste list_var werden die Elemente ab einschließlich Position pos1 bis ausschließlich Position pos2 entfernt und gelöscht. Es werden allerdings nur dann Elemente entfernt, wenn nach der Normierung pos1<pos2 ist. Die Anzahl der entfernten Elemente berechnet sich dann aus N:=pos2-pos1. Alle den entfernten Elementen nachfolgenden Elemente werden um N nach vorne verschoben und die Anzahl der Listenelemente veringert sich um N.

Ohne Angabe von pos2 wird nur das eine Element mit dem Index pos1 entfernt und gelöscht.

Funktionsergebnis: INT32

Als Funktionsergebnis wird der Index des ersten entferneten Elementes geliefert, oder -1, falls kein Element entfernt wurde.

Siehe auch:
l$move()

Weitere ähnliche Funktionen:

Listen
Funktion	Kurzinfo
alignList()	—
bitField2list()	Aus einem Bitfeld eine numerische Liste erzeugen.
catList()	Eine Liste mit den Kopien der einzelnen Parameter erzeugen. Aus Listen und Maps werden alle Elemente einzeln kopiert.
flatList()	Die komplette Listen- und/oder Map-Struktur in eine flache Liste überführen.
flatListNum()	Die komplette Listen- und/oder Map-Struktur in eine flache Liste überführen und numerische Werte kopieren.
isList()	Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ LIST ist.
l$align()	—
l$append()	Ein Element an das Ende einer Liste anfügen.
l$appendList()	—
l$bitField()	Aus den numerischen Elementen einer Liste wird ein Bitfeld erzeugt.
l$cat()	Eine Liste aus den einzelnen Parameter erzeugen. Aus Listen und Maps werden alle Elemente einzeln kopiert.
l$clear()	—
l$copy()	Den Teilbereich einer Liste kopieren.
l$insert()	—
l$insertList()	—
l$isSorted()	Ist eine Liste sortiert?
l$isSortModeLex()	ist der Sortier-Modus einer Liste lexikalisch?
l$length()	Die Anzahl der Elemente einer Liste bestimmen.
l$list()	—
l$move()	Den Teilbereich einer Liste kopieren.
l$pack()	—
l$purge()	—
l$randomize()	—
l$remove()	Elemente aus einer Liste entfernen.
l$replace()	—
l$replaceList()	—
l$reverse()	—
l$setLength()	—
l$setSize()	—
l$size()	—
l$sort()	—
l$sortLex()	—
l$unique()	Elemente, die sich wiederholen, aus einer Liste entfernen.
len()	Die Anzahl der Zeichen einer Zeichenkette bzw. die Anzahl der Elemente einer Liste oder einer Map bestimmen.
length()	Die Anzahl der Zeichen einer Zeichenkette bzw. die Anzahl der Elemente einer Liste oder einer Map bestimmen.
list()	Eine Liste mit den Kopien der einzelnen Parameter erzeugen.
list2()	—
randomize()	—
reverse()	—
unique()	Elemente, die sich wiederholen, aus einer Liste entfernen.
vector()	Eine Liste mit identischen bzw. inkrementierten Werten generieren.