Hop til hovedindhold

List.Sort

Sorterer en liste over data i overensstemmelse med de angivne kriterier.

Syntax​

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

Remarks​

Sorterer en liste over data, list, i overensstemmelse med de angivne valgfrie kriterier. Du kan angive en valgfri parameter, comparisonCriteria, som sammenligningskriterie. Den kan tage følgende værdier:

  • Hvis du vil styre rækkefølgen, kan sammenligningskriteriet være en værdi af typen Order enum. (Order.Descending, Order.Ascending).
  • Hvis du vil beregne en nøgle, der skal bruges til sortering, kan der bruges en funktion med ét argument.
  • Hvis du både vil vælge en nøgle og styre rækkefølgen, kan sammenligningskriteriet være en liste, der indeholder nøglen og rækkefølgen ({each 1 / _, Order.Descending}).
  • Hvis du vil styre sammenligningen fuldstændig, kan der bruges en funktion med to argumenter. Denne funktion overføres til to elementer fra listen (to vilkårlige elementer i en hvilken som helst 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.

Examples​

Example #1​

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

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

Result:

{1, 2, 3}

Example #2​

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

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

Result:

{3, 2, 1}

Example #3​

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

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

Result:

{3, 2, 1}

Category​

List.Ordering