使用英语阅读

通过


List.Sort

语法

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

关于

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

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