Lire en anglais

Partager via


List.Sort

Syntaxe

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

À propos

Trie une liste de données, list, selon les critères facultatifs spécifiés. Un paramètre facultatif, comparisonCriteria, peut être spécifié comme critère de comparaison. Les valeurs possibles sont les suivantes :

  • Pour contrôler l’ordre, le critère de comparaison peut être une valeur d’énumération d’ordre. (Order.Descending, Order.Ascending).

  • Pour calculer une clé à utiliser pour le tri, une fonction de 1 argument peut être utilisée.

  • Pour à la fois sélectionner une clé et contrôler l’ordre, le critère de comparaison peut être une liste contenant la clé et l’ordre ({each 1 / _, Order.Descending}).

  • Pour contrôler complètement la comparaison, une fonction de 2 arguments peut être utilisée. Deux éléments de la liste seront passés à cette fonction (deux éléments quelconques, dans n’importe quel ordre). La fonction doit retourner l’une des valeurs suivantes :

    • -1 : le premier élément est inférieur au second.
    • 0 : les éléments sont égaux.
    • 1 : le premier élément est supérieur au second.

    Value.Compare est une méthode qui peut être utilisée pour déléguer cette logique.

Exemple 1

Trie la liste {2, 3, 1}.

Utilisation

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

Sortie

{1, 2, 3}

Exemple 2

Trie la liste {2, 3, 1} dans l’ordre décroissant.

Utilisation

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

Sortie

{3, 2, 1}

Exemple 3

Trie la liste {2, 3, 1} dans l’ordre décroissant en utilisant la méthode Value.Compare.

Utilisation

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

Sortie

{3, 2, 1}