List.Sort

Sortiert eine Liste mit Daten gemäß den angegebenen Kriterien.

Syntax

List.Sort(
    list as list,
    optional comparisonCriteria as any
) as list

Remarks

Sortiert eine Liste mit Daten (list) gemäß den angegebenen optionalen Kriterien. Als Vergleichskriterium kann ein optionaler Parameter (comparisonCriteria) angegeben werden. Dieser akzeptiert folgende Werte:

• Zum Steuern der Reihenfolge kann als Vergleichskriterium ein Order-Enumerationswert angegeben werden. (Order.Descending, Order.Ascending)
• Zum Berechnen eines Schlüssels für die Sortierung kann eine Funktion mit einem einzelnen Argument verwendet werden.
• Um sowohl einen Schlüssel auszuwählen als auch die Reihenfolge zu steuern, kann das Vergleichskriterium als Liste mit Schlüssel und Reihenfolge ({each 1 / _, Order.Descending}) angegeben werden.
• Zur vollständigen Steuerung des Vergleichs kann eine Funktion mit zwei Argumenten verwendet werden. Dieser Funktion werden zwei Elemente aus der Liste übergeben (zwei beliebige Elemente in beliebiger Reihenfolge). Die Funktion sollte einen der folgenden Werte zurückgeben:
  • -1: Das erste Element ist kleiner als das zweite Element.
  • 0: Die Elemente sind gleichwertig.
  • 1: Das erste Element ist größer als das zweite Element.
  "Value.Compare" ist eine Methode, mit der diese Logik delegiert werden kann.

Examples

Example #1

Sortiert die Liste "{2, 3, 1}".

List.Sort({2, 3, 1})

Result:

{1, 2, 3}

Example #2

Sortiert die Liste "{2, 3, 1}" in absteigender Reihenfolge.

List.Sort({2, 3, 1}, Order.Descending)

Result:

{3, 2, 1}

Example #3

Sortiert die Liste "{2, 3, 1}" in absteigender Reihenfolge unter Verwendung der Value.Compare-Methode.

List.Sort({2, 3, 1}, (x, y) => Value.Compare(1/x, 1/y))

Result:

{3, 2, 1}

Category

List.Ordering