List.Sortér

Syntaks

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

Om

Sorterer en liste over data, list, i henhold til de angivne valgfrie kriterier. En valgfri parameter, comparisonCriteria, kan angives som sammenligningskriterium. Dette kan tage følgende værdier:

  • Sammenligningskriteriet kan være en værdi af typen Order enum for at styre rækkefølgen. (Order.Descending, Order.Ascending).

  • Hvis du vil beregne en nøgle, der skal bruges til sortering, kan der bruges en funktion med 1 argument.

  • Hvis du både vil vælge en nøgle og en kontrolrækkefølge, kan sammenligningskriteriet være en liste, der indeholder nøglen og rækkefølgen ({each 1 / _, Order.Descending}).

  • Hvis du vil have fuld kontrol over sammenligningen, kan du bruge en funktion med to argumenter. Denne funktion overføres to elementer fra listen (to elementer i vilkårlig rækkefølge). Funktionen skal returnere en af følgende værdier:

    • -1: Det første element er mindre end det andet element.
    • 0: Elementerne er ens.
    • 1: Det første element er større end det andet element.

    Value.Compare er en metode, der kan bruges til at delegere denne logik.

Eksempel 1

Sortér listen {2, 3, 1}.

Brug

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

Output

{1, 2, 3}

Eksempel 2

Sortér listen {2, 3, 1} i faldende rækkefølge.

Brug

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

Output

{3, 2, 1}

Eksempel 3

Sortér listen {2, 3, 1} i faldende rækkefølge ved hjælp af metoden Value.Compare .

Brug

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

Output

{3, 2, 1}