List.Sort

構文

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 は、このロジックを委任するために使用できるメソッドです。

例 1

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

使用方法

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

出力

{1, 2, 3}

例 2

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

使用方法

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

出力

{3, 2, 1}

例 3

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

使用方法

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

出力

{3, 2, 1}