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

Beliebiger Wert, der an das Ende der Liste list_var angefügt wird.

Beschreibung:

Nach der Zwangswandlung von var_liste in eine Liste wird das Element x an das Ende dieser Liste eingefügt.

Funktionsergebnis: INT32

Als Funktionsergebnis wird der Index des eingefügten Elementes geliefert.

Siehe auch:
l$appendList() l$insert() l$replace() l$remove()

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.