List.Sort
List.Sort(list as list, optional comparisonCriteria as any) as list
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.
Trie la liste {2, 3, 1}.
Utilisation
List.Sort({2, 3, 1})
Sortie
{1, 2, 3}
Trie la liste {2, 3, 1} dans l’ordre décroissant.
Utilisation
List.Sort({2, 3, 1}, Order.Descending)
Sortie
{3, 2, 1}
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}