prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » l$move()

l$move()

Den Teilbereich einer Liste kopieren.

Syntax:

list l$move ( list_var, pos1, pos2 )

Parameter:

list_var Die Funktion l$move 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, aus dem die Listen-Elemente verschoben werden sollen.

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 in eine neue Liste verschoben. Es werden allerdings nur dann Elemente verschoben, wenn nach der Normierung pos1<pos2 ist. Die Anzahl der verschoben Elemente ist gleichzeitig die Anzahl der aus list_var entferneten Elemente und berechnet sich dann aus pos2-pos1.

l$move() entspricht einer Kombination aus l$copy() und l$remove() mit identischen Parametern.

Funktionsergebnis:   LIST

Als Funktionsergebnis wird eine neue Liste mit den verschoben Elementen geliefert.

Siehe auch:
 l$copy()   l$remove()   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.