List.Sort

Сортує список даних відповідно до вказаних критеріїв.

Syntax

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

Remarks

Сортує список даних list відповідно до вказаних додаткових умов. Можна вказати додатковий параметр comparisonCriteria як умову порівняння. Він може приймати наведені нижче значення.

• Для керування порядком як умову порівняння можна вказати значення порядку перелічення. (Order.Descending, Order.Ascending).
• Щоб обчислити ключ для сортування, можна використати функцію з 1 аргументом.
• Щоб вибрати ключ і контролювати порядок, умову порівняння можна вказати як список із ключем і значенням порядку ({each 1 / _, Order.Descending}).
• Щоб повністю контролювати порівняння, можна використати функцію з 2 аргументами (як-от Value.Compare). Цій функції буде передано два елементи зі списку (будь-які два елементи в будь-якому порядку). Функція має повернути одне з наведених нижче значень:
  • -1: перший елемент менше другого елемента.
  • 0: елементи рівні.
  • 1: перший елемент більше другого елемента.

Examples

Example #1

Сортувати список {2, 3, 1}.

List.Sort({2, 3, 1})

Result:

{1, 2, 3}

Example #2

Сортувати список {2, 3, 1} за спаданням.

List.Sort({2, 3, 1}, Order.Descending)

Result:

{3, 2, 1}

Example #3

Сортувати список {2, 3, 1} за спаданням, використовуючи метод Value.Compare.

List.Sort({2, 3, 1}, (x, y) => Value.Compare(1/x, 1/y))

Result:

{3, 2, 1}

Category

List.Ordering