Fonctions de liste

Article
05/02/2025

Ces fonctions créent et manipulent des valeurs de liste.

Information

Nom	Description
List.Count	Retourne le nombre d’éléments d’une liste.
List.IsEmpty	Retourne `true` si la liste est vide.
List.NonNullCount	Retourne le nombre d’éléments non nuls dans la liste.

Sélection

Nom	Description
List.Alternate	Retourne une liste composée de tous les éléments de décalage impairs d’une liste.
List.Buffer	Met en mémoire tampon une liste.
List.Distinct	Retourne une liste de valeurs avec des doublons supprimés.
List.FindText	Retourne une liste de valeurs (y compris les champs d’enregistrement) qui contiennent le texte spécifié.
List.First	Retourne la première valeur de la liste ou la valeur par défaut spécifiée si elle est vide.
List.FirstN	Retourne le premier ensemble d’éléments de la liste en spécifiant le nombre d’éléments à retourner ou une condition éligible.
List.InsertRange	Insère des valeurs dans une liste à l’index donné.
List.IsDistinct	Indique s’il existe des doublons dans la liste.
List.Last	Retourne la dernière valeur de la liste ou la valeur par défaut spécifiée si elle est vide.
List.LastN	Retourne la dernière valeur de la liste. Peut éventuellement spécifier le nombre de valeurs à retourner ou une condition admissible.
List.MatchesAll	Retourne `true` si la fonction condition est satisfaite par toutes les valeurs de la liste.
List.MatchesAny	Retourne `true` si la fonction de condition est satisfaite par n’importe quelle valeur.
List.Positions	Retourne une liste de décalages pour l'entrée.
List.Range	Retourne un sous-ensemble de liste démarrant à un décalage.
List.Select	Retourne une liste de valeurs qui correspondent à la condition.
List.Single	Retourne un seul élément de liste pour une liste de longueur un, sinon lève une exception.
List.SingleOrDefault	Retourne un seul élément de liste pour une liste de longueur un, et la valeur par défaut pour une liste vide.
List.Skip	Retourne une liste qui ignore le nombre spécifié d'éléments au début de la liste.

Fonctions de transformation

Nom	Description
List.Accumulate	Accumule une valeur de synthèse des éléments de la liste.
List.Combine	Retourne une seule liste en combinant plusieurs listes.
List.ConformToPageReader	Cette fonction est destinée uniquement à une utilisation interne.
List.RemoveFirstN	Retourne une liste qui ignore le nombre spécifié d'éléments au début de la liste.
List.RemoveItems	Supprime les éléments de la première liste présentes dans la deuxième liste.
List.RemoveLastN	Retourne une liste qui supprime le nombre spécifié d’éléments de la fin de la liste.
List.RemoveMatchingItems	Supprime toutes les occurrences des valeurs d’entrée.
List.RemoveNulls	Supprime toutes les valeurs `null` de la liste spécifiée.
List.RemoveRange	Supprime le nombre de comptage des valeurs démarrant à la position spécifiée.
List.Repeat	Retourne une liste qui contient `count` répétitions de la liste d’origine.
List.ReplaceMatchingItems	Remplace les occurrences des valeurs existantes dans la liste par de nouvelles valeurs qui correspondent à la condition.
List.ReplaceRange	Remplace le nombre `count` de valeurs à partir de `position` avec les valeurs de remplacement.
List.ReplaceValue	Recherche une liste pour la valeur spécifiée et la remplace.
List.Reverse	Inverse l’ordre des valeurs dans la liste.
List.Split	Fractionne la liste spécifiée en une liste de listes à l’aide de la taille de page spécifiée.
List.Transform	Retourne une nouvelle liste de valeurs calculées à partir de cette liste.
List.TransformMany	Retourne une liste dont les éléments sont transformés à partir de la liste d’entrée à l’aide de fonctions spécifiées.
List.Zip	Retourne une liste de listes en combinant des éléments à la même position dans plusieurs listes.

Fonctions d’appartenance

Étant donné que toutes les valeurs peuvent être testées pour l’égalité, ces fonctions peuvent fonctionner sur des listes hétérogènes.

Nom	Description
List.AllTrue	Retourne `true` si toutes les expressions sont vraies.
List.AnyTrue	Retourne true si une expression est vraie.
List.Contains	Indique si la liste contient la valeur.
List.ContainsAll	Indique où une liste inclut toutes les valeurs d’une autre liste.
List.ContainsAny	Indique où une liste inclut l’une des valeurs d’une autre liste.
List.PositionOf	Retourne les décalages d'une valeur dans une liste.
List.PositionOfAny	Retourne le premier décalage d’une valeur dans une liste.

Définir des opérations

Nom	Description
List.Difference	Retourne la différence entre les deux listes spécifiées.
List.Intersect	Retourne l’intersection des valeurs de liste trouvées dans l’entrée.
List.Union	Retourne l’union des valeurs de liste trouvées dans l’entrée.

Classement

Les fonctions de classement effectuent des comparaisons. Toutes les valeurs comparées doivent être comparables entre elles. Cela signifie qu’ils doivent tous provenir du même type de données (ou inclure null, qui compare toujours le plus petit). Dans le cas contraire, un Expression.Error est déclenché.

Les types de données comparables sont les suivants :

Nombre
Durée
Date/Heure
Texte
Logique
Zéro

Nom	Description
List.Max	Retourne la valeur maximale ou la valeur par défaut d’une liste vide.
List.MaxN	Retourne la ou les valeurs maximales dans la liste. Le nombre de valeurs à retourner ou une condition de filtrage doit être spécifié.
List.Median	Retourne la valeur médiane dans la liste.
List.Min	Retourne la valeur minimale ou la valeur par défaut d’une liste vide.
List.MinN	Retourne la ou les valeurs minimales dans la liste. Le nombre de valeurs à retourner ou une condition de filtrage peut être spécifié.
List.Sort	Trie une liste de données en fonction des critères spécifiés.
List.Percentile	Retourne un ou plusieurs percentiles d’échantillon correspondant aux probabilités données.

Moyennes

Ces fonctions opèrent sur des listes homogènes de nombres numériques, de dates et heures, et de durées.

Nom	Description
List.Average	Retourne la moyenne des valeurs. Fonctionne avec les valeurs nombre, date, datetime, datetimezone et durée.
List.Mode	Retourne la valeur la plus fréquente dans la liste.
List.Modes	Retourne une liste des valeurs les plus fréquentes de la liste.
List.StandardDeviation	Retourne une estimation basée sur un échantillon de l’écart type. Cette fonction effectue une estimation basée sur un exemple. Le résultat est un nombre pour les nombres et une durée pour les valeurs Dates/Heures et les durées.

Ajout

Ces fonctions fonctionnent sur des listes homogènes de nombres ou de durées.

Nom	Description
List.Sum	Retourne la somme des éléments de la liste.

Numériques

Ces fonctions fonctionnent uniquement sur les nombres.

Nom	Description
List.Covariance	Retourne la covariance entre les deux listes de nombres.
List.Product	Retourne le produit des nombres de la liste.

Générateurs

Ces fonctions génèrent la liste des valeurs.

Nom	Description
List.Dates	Génère une liste de valeurs `date` en fonction d’une valeur initiale, d’un nombre et d’une valeur de durée incrémentielle.
List.DateTimes	Génère une liste de valeurs `datetime` en fonction d’une valeur initiale, d’un nombre et d’une valeur de durée incrémentielle.
List.DateTimeZones	Génère une liste de valeurs `datetimezone` en fonction d’une valeur initiale, d’un nombre et d’une valeur de durée incrémentielle.
List.Durations	Génère une liste de valeurs `duration` en fonction d’une valeur initiale, d’un nombre et d’une valeur de durée incrémentielle.
List.Generate	Génère une liste de valeurs.
List.Numbers	Retourne une liste de nombres en fonction d’une valeur initiale, d’un nombre et d’une valeur d’incrément facultative.
List.Random	Retourne une liste de nombres aléatoires.
List.Times	Génère une liste de valeurs `time` en fonction d’une valeur initiale, d’un nombre et d’une valeur de durée incrémentielle.

Valeurs des paramètres

Spécification de l’occurrence

Ordre de tri

Order.Ascending = 0;
Order.Descending = 1;

Critères d’équation

Les critères d’équation des valeurs de liste peuvent être spécifiés comme suit :

Valeur de fonction qui est l’une des suivantes :
- Un sélecteur de clé qui détermine la valeur de la liste pour appliquer les critères d’égalité.
- Fonction comparateur utilisée pour spécifier le type de comparaison à appliquer. Vous pouvez spécifier les fonctions de comparaison intégrées : accédez à fonctions de comparaison.
Une valeur de liste qui a les attributs suivants :
- Exactement deux éléments.
- Le premier élément est le sélecteur de clé tel que spécifié ci-dessus.
- Le deuxième élément est un comparateur tel que spécifié ci-dessus.

Pour plus d’informations et d’exemples, accédez à List.Distinct.

Critères de comparaison

Les critères de comparaison peuvent être fournis comme l’une des valeurs suivantes :

Valeur numérique pour spécifier un ordre de tri. Pour plus d'informations, accédez à Ordre de tri.
Pour calculer une clé à utiliser pour le tri, une fonction d’un argument peut être utilisée.
Pour sélectionner une clé et un ordre de contrôle, le critère de comparaison peut être une liste contenant la clé et l’ordre.
Pour contrôler complètement la comparaison, une fonction de deux arguments peut être utilisée qui retourne -1, 0 ou 1 en fonction de la relation entre les entrées de gauche et de droite. Value.Compare est une méthode qui peut être utilisée pour déléguer cette logique.

Pour plus d’informations et d’exemples, accédez à List.Sort.

Opérations de remplacement

Les opérations de remplacement sont spécifiées par une valeur de liste. Chaque élément de cette liste doit être :

Une valeur de liste de deux éléments exactement.
Le premier élément est l’ancienne valeur de la liste à remplacer.
Le deuxième élément est la nouvelle valeur, qui doit remplacer toutes les occurrences de l’ancienne valeur dans la liste.

Partager via