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

l$sort()

Syntax:

int32 l$sort ( list_var )

Parameter:

list_var Die Funktion l$sort 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$sort ( list_var )'
'l$sortlex ( list_var )'

Zuerst 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 die Liste sortiert, so das das kleineste Element vorne (bei Index 0) steht. Für den Vergleich wird cmp() bzw. cmplex(), verwendet.

Als Funktionsergebnis wird die Anzahl der Elemente der Liste geliefert.

Funktionsergebnis:

Siehe auch:
 l$sortLex()   l$isSorted()   l$isSortModeLex() 

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.
 
Sortieren
Funktion Kurzinfo
l$isSorted() Ist eine Liste sortiert?
l$isSortModeLex() ist der Sortier-Modus einer Liste lexikalisch?
l$sort()
l$sortLex()
sort()
sortLex()
sortString()