Fonctions de liste

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

Information

Nom	Description
List.Count	Retourne le nombre d’éléments dans une liste.
List.NonNullCount	Retourne le nombre d’éléments dans une liste en excluant les valeurs Null
List.IsEmpty	Retourne une valeur indiquant si une liste est vide.

Sélection

Nom	Description
List.Alternate	Retourne une liste avec les éléments alternés de la liste d’origine, en fonction d’un nombre count de valeurs, d’un repeatInterval facultatif et d’un offset facultatif.
List.Buffer	Met la liste en mémoire tampon. Le résultat de cet appel est une liste stable, ce qui signifie qu’elle aura un nombre et un ordre d’éléments déterministes.
List.Distinct	Filtre une liste en supprimant les doublons. Vous pouvez spécifier une valeur de critère d’égalité facultative pour contrôler la comparaison d’égalité. La première valeur de chaque groupe d’égalités est choisie.
List.FindText	Recherche une valeur texte dans une liste de valeurs, y compris dans des champs d’enregistrement.
List.First	Retourne la première valeur de la liste ou la valeur par défaut spécifiée si elle est vide. Retourne le premier élément de la liste ou la valeur par défaut facultative si la liste est vide. Si la liste est vide et qu’une valeur par défaut n’est pas spécifiée, la fonction retourne.
List.FirstN	Retourne le premier ensemble d’éléments de la liste en spécifiant le nombre d’éléments à retourner ou une condition qualifiante fournie par countOrCondition.
List.InsertRange	Insère des éléments de values à l’index donné dans la liste d’entrée.
List.IsDistinct	Retourne une valeur indiquant si une liste est distincte.
List.Last	Retourne le dernier ensemble d’éléments de la liste en spécifiant le nombre d’éléments à retourner ou une condition qualifiante fournie par countOrCondition.
List.LastN	Retourne le dernier ensemble d’éléments d’une liste en spécifiant le nombre d’éléments à retourner ou une condition qualifiante.
List.MatchesAll	Retourne true si tous les éléments d’une liste remplissent une condition.
List.MatchesAny	Retourne true si au moins un élément d’une liste remplit une condition.
List.Positions	Retourne une liste de positions pour une liste d’entrée.
List.Range	Retourne un nombre count d’éléments en commençant à un offset.
List.Select	Sélectionne les éléments qui correspondent à une condition.
List.Single	Retourne le seul élément de la liste ou lève une Expression.Error si la liste contient plusieurs éléments.
List.SingleOrDefault	Retourne un seul élément d’une liste.
List.Skip	Ignore le premier élément de la liste. Pour une liste vide, retourne une liste vide. Cette fonction accepte un paramètre facultatif countOrCondition, ce qui lui permet d’ignorer plusieurs valeurs.

Fonctions de transformation

Nom	Description
List.Accumulate	Calcule un total cumulé à partir de la liste. À partir de la valeur initiale (seed), cette fonction applique la fonction d’accumulation et retourne le résultat final.
List.Combine	Fusionne une liste de listes en une seule liste.
List.ConformToPageReader	Cette fonction est réservée à un usage interne uniquement.
List.RemoveRange	Retourne une liste qui supprime un nombre count d’éléments en commençant à un offset. Le nombre par défaut est 1.
List.RemoveFirstN	Retourne une liste avec le nombre spécifié d’éléments supprimés de la liste en commençant au premier élément. Le nombre d’éléments supprimés dépend du paramètre facultatif countOrCondition.
List.RemoveItems	Supprime les éléments de list1 qui sont présents dans list2, puis retourne une nouvelle liste.
List.RemoveLastN	Retourne une liste avec le nombre spécifié d’éléments supprimés de la liste en commençant au dernier élément. Le nombre d’éléments supprimés dépend du paramètre facultatif countOrCondition.
List.Repeat	Retourne une liste qui répète count fois le contenu d’une liste en entrée.
List.ReplaceRange	Retourne une liste qui remplace un nombre count de valeurs dans une liste par une liste replaceWith en commençant à un index.
List.RemoveMatchingItems	Supprime toutes les occurrences des valeurs données dans la liste.
List.RemoveNulls	Supprime les valeurs Null d’une liste.
List.ReplaceMatchingItems	Remplace les occurrences de valeurs existantes dans la liste par de nouvelles valeurs en utilisant les critères d’égalité equationCriteria fournis. Les anciennes et les nouvelles valeurs sont fournies par les paramètres replacements. Vous pouvez spécifier une valeur de critère d’égalité facultative pour contrôler les comparaisons d’égalité. Pour plus d’informations sur les opérations de remplacement et les critères d’égalité, accédez à Valeurs des paramètres.
List.ReplaceValue	Recherche la valeur dans une liste de valeurs et remplace chaque occurrence avec la valeur de remplacement.
List.Reverse	Retourne une liste qui inverse les éléments d’une liste.
List.Split	Divise la liste spécifiée en une liste de listes en utilisant la taille de page spécifiée.
List.Transform	Exécute la fonction sur chaque élément de la liste et retourne la nouvelle liste.
List.TransformMany	Retourne une liste dont les éléments sont projetés à partir de la liste d’entrée.

Fonctions d’appartenance

Dans la mesure où l’égalité de toutes les valeurs peut être testée, ces fonctions peuvent travailler sur des listes hétérogènes.

Nom	Description
List.AllTrue	Retourne true si toutes les expressions d’une liste ont la valeur true
List.AnyTrue	Retourne true si au moins une des expressions d’une liste a la valeur true
List.Contains	Retourne true si une valeur est trouvée dans une liste.
List.ContainsAll	Retourne true si tous les éléments de values sont trouvés dans une liste.
List.ContainsAny	Retourne true si au moins un élément de values est trouvé dans une liste.
List.PositionOf	Recherche la première occurrence d’une valeur dans une liste et retourne sa position.
List.PositionOfAny	Recherche la première occurrence d’une valeur de values et retourne sa position.

Opérations sur les ensembles

Nom	Description
List.Difference	Retourne les éléments de la liste 1 qui n’apparaissent pas dans la liste 2. Les valeurs en doublon sont prises en charge.
List.Intersect	Retourne une liste à partir d’une liste de listes et effectue une opération d’intersection des éléments communs des listes individuelles. Les valeurs en doublon sont prises en charge.
List.Union	Retourne une liste à partir d’une liste de listes et effectue une opération d’union des éléments des listes individuelles. La liste retournée contient tous les éléments des listes d’entrée. Les valeurs en doublon sont intégrées au résultat de l’union.
List.Zip	Retourne une liste de listes en combinant des éléments à la même position.

Classement

Les fonctions de classement effectuent des comparaisons. Toutes les valeurs comparées doivent être comparables entre elles. Cela signifie qu’elles doivent toutes provenir du même type de données (ou inclure Null, qui est toujours inférieur lors d’une comparaison). Sinon, une exception Expression.Error est levée.

Les types de données comparables sont les suivants :

• Nombre
• Duration
• DateTime
• Texte
• Logique
• Null

Nom	Description
List.Max	Retourne l’élément maximal d’une liste ou la valeur par défaut facultative si la liste est vide.
List.MaxN	Retourne les valeurs maximales d’une liste. Le nombre de valeurs à retourner ou une condition de filtrage doit être spécifié(e).
List.Median	Retourne l’élément médian d’une liste.
List.Min	Retourne l’élément minimal d’une liste ou la valeur par défaut facultative si la liste est vide.
List.MinN	Retourne les valeurs minimales d’une liste. Le nombre de valeurs à retourner ou une condition de filtrage peut être spécifié(e).
List.Sort	Retourne une liste triée en utilisant un critère de comparaison.
List.Percentile	Retourne un ou plusieurs exemples de centile correspondant aux probabilités données.

Moyennes

Ces fonctions travaillent sur des listes homogènes de nombres, de valeurs datetime et de durées.

Nom	Description
List.Average	Retourne une valeur moyenne à partir d’une liste dans le type de données des valeurs de la liste.
List.Mode	Retourne un élément qui apparaît le plus souvent dans une liste.
List.Modes	Retourne tous les éléments qui apparaissent avec la même fréquence maximale.
List.StandardDeviation	Retourne l’écart type d’une liste de valeurs. List.StandardDeviation effectue une estimation basée sur un échantillon. Le résultat est un nombre pour les nombres et une durée pour les valeurs datetime et les durées.

Addition

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

Nom	Description
List.Sum	Retourne la somme d’une liste.

Fonctions numériques

Ces fonctions ne travaillent que sur des nombres.

Nom	Description
List.Covariance	Retourne la covariance de deux listes sous la forme d’un nombre.
List.Product	Retourne le produit d’une liste de nombres.

Générateurs

Ces fonctions génèrent une liste de valeurs.

Nom	Description
List.Dates	Retourne une liste de valeurs de date d’une taille count, en commençant au début et en ajoutant un incrément à chaque valeur.
List.DateTimes	Retourne une liste de valeurs datetime d’une taille count, en commençant au début et en ajoutant un incrément à chaque valeur.
List.DateTimeZones	Retourne une liste de valeurs datetimezone d’une taille count, en commençant au début et en ajoutant un incrément à chaque valeur.
List.Durations	Retourne une liste de valeurs de durées d’une taille count, en commençant au début et en ajoutant un incrément à chaque valeur.
List.Generate	Génère une liste de valeurs.
List.Numbers	Retourne une liste de nombres d’une taille count, en commençant à une valeur initiale et en ajoutant un incrément. La valeur par défaut de l’incrément est 1.
List.Random	Retourne une liste de count nombres aléatoires, avec un paramètre facultatif de valeur initiale.
List.Times	Retourne une liste de valeurs d’heure de taille count, en commençant à start.

Valeurs de paramètres

Spécification des occurrences

• Occurrence.First = 0;
• Occurrence.Last = 1;
• Occurrence.All = 2;

Ordre de tri

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

Critères d’égalité

Les critères d’égalité pour les valeurs de liste peuvent être spécifiés comme suit :

• Une valeur de fonction qui peut être :
  • Un sélecteur de clé qui détermine la valeur de la liste pour appliquer les critères d’égalité.
  • Une fonction de comparateur utilisée pour spécifier le type de comparaison à appliquer. Des fonctions de comparateur intégrées peuvent être spécifiées ; accédez à Fonctions de comparaison.
• Une valeur de liste qui a :
  • 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 obtenir plus d’informations et des exemples, accédez à List.Distinct.

Critères de comparaison

Un critère de comparaison peut être fourni sous forme d’une des valeurs suivantes :

• Une 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 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.
• Pour contrôler complètement la comparaison, une fonction de 1, 0 arguments peut être utilisée, qui retourne -1 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 obtenir plus d’informations et des 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, destiné à être remplacer.
• Le deuxième élément est la nouvelle valeur qui doit remplacer toutes les occurrences de l’ancienne valeur dans la liste.