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 個引數的函數 (例如 Value.Compare)。此函數將從清單中傳遞兩個項目 (任何兩個項目，以任何順序)。該函數應返回下列其中一個值:
- -1: 第一項小於第二項。
- 0: 兩個項目相等。
- 1: 第一項大於第二項。

將清單 {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}