l$insert()

Syntax:

int32

l$insert ( list_var, position, x )

Parameter:

list_var

Die Funktion l$insert 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.

?doc?

Beschreibung:

Der folgende Text wurde 1:1 aus der alten Dokumentation kopiert und muss evtl. noch auf den aktuellen Stand gebracht werden.

Syntax: 'l$insert ( list_var, index, x )'

Nach der Auswertung aller Parameter wird die Existens und der Typ der Variablen LIST_VAR überprüft, wobei natürlich auch indizierte Variablen erlaubt sind. Existiert diese nicht oder handelt es sich nicht um eine LISTE, dann wird eine leere Liste mit dem angegebenen Variablennamen (und Index) erzeugt.

Anschließend wird der Wert X an der Position INDEX eingefügt. Alle nachfolgenden Element werden um eine Postion nach hinten geschoben. Das erste Element hat den Index 0.

Der INDEX ist robust, so dass für ihn jeglicher Wert angegeben werden kann. Bei Positionsangaben wird zur Normierung die Funktion index() angewendet: Werte < 0 werden als relative Angaben zum Listenende angesehen. Sind die Werte nach der Nomierung < 0, so wird 0 verwendet. Ist INDEX > als die Elementanzahl, so werden viele neue Elemente mit dem Wert @NONE als Füller eingefügt.

Als Funktionsergebnis wird der Index des neuen Elementes geliefert.

Funktionsergebnis:

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.

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()