List.Sort

Syntax

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

About

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

  • 若要控制顺序,比较条件可以是 Order 枚举值。 (Order.DescendingOrder.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}