List.Sort

指定された条件に従ってデータのリストを並べ替えます。

Syntax

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

省略可能な指定された条件に従ってデータのリスト list を並べ替えます。省略可能なパラメーター comparisonCriteria は、比較条件として指定できます。次の値を指定できます。

順序を制御するには、比較条件に Order 列挙値を指定できます (Order.Descending、Order.Ascending)。
並べ替えに使用するキーを計算するには、1 つの引数を指定した関数を使用できます。
キーを選択し、さらに順序を制御するには、比較条件にキーと順序を含むリスト ({each 1 / _, Order.Descending}) を使用できます。
完全に比較を制御するには、2 つの引数の関数を使用できます。この関数には、リストから 2 つのアイテム（任意の 2 つのアイテム、任意の順序）が渡されます。この関数は、次のいずれかの値を返す必要があります:
- -1: 最初のアイテムが 2 番目のアイテムよりも小さい。
- 0: アイテムは同じです。
- 1: 最初のアイテムが 2 番目のアイテムよりも大きいです。
Value.Compare は、このロジックをデリゲートするために使用できるメソッドです。

リスト {2, 3, 1} を並べ替えます。

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

Result:

{1, 2, 3}

リスト {2, 3, 1} を降順に並べ替えます。

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

Result:

{3, 2, 1}

Value.Compare メソッドを使用してリスト {2, 3, 1} を降順に並べ替えます。

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

Result:

{3, 2, 1}