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}