List.Sort

语法

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

关于

根据指定的可选条件对数据列表 list 排序。 可选参数 comparisonCriteria 可以指定为比较条件。 这可以采用以下值：

• 为控制顺序，比较条件可以是顺序枚举值。 (Order.Descending, Order.Ascending).

• 若要计算用于排序的键，可以使用具有 1 个参数的函数。

• 若要选择键并控制顺序，比较条件可以是包含键和顺序 ({ each 1 / _, Order.Descending }) 的列表。

• 若要完全控制比较，可以使用 2 个参数的函数。 此函数将从列表中传递两个项（任意顺序的任意两个项）。 该函数应返回以下值之一：

  • -1：第一项小于第二项。
  • 0：两个项相等。
  • 1：第一项大于第二项。

  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 }