Die Funktion collection.sort( ) sortiert die Elemente der Collection und gibt auch die sortierte Collection zurück.
Hinweis: Diese Funktion verändert die ursprüngliche Collection.
Wird collection.sort( ) ohne Parameter aufgerufen, werden nur skalare Werte (Zahl, Text, Datum, Boolean) sortiert. Elemente werden standardmäßig nach Typ und in autsteigender Reihenfolge sortiert.
Wollen Sie Collection Elemente in anderer Reihenfolge oder jeden Elementtyp sortieren, müssen Sie in MethodenName eine Vergleichsmethode einrichten, die zwei Werte vergleicht und wahr in $1.result zurückgibt, wenn der erste Wert niedriger als der zweite ist. Sie können bei Bedarf weitere Parameter übergeben:
- MethodenName empfängt folgende Parameter:
- $1 (object), where:
- $1.value (beliebiger Typ): erster Elementwert zum Vergleichen
- $1.value2 (beliebiger Typ): zweiter Elementwert zum Vergleichen
- $2...$N (beliebiger Typ): extra Parameter
- MethodenName setzt folgende Parameter:
- $1.result (boolean): wahr wenn $1.value < $1.value2, sonst falsch
Enthält die Collection Elemente mit unterschiedlichen Typen, werden sie erst nach Typ gruppiert und anschließend sortiert. Typen werden in folgender Reihenfolge zurückgegeben:
- Null
- Boolean
- String
- Zahl
- Objekt
- Collection
- Datum
C_OBJECT($1)
$1.result:=String($1.value)<String($1.value2)