Lire en anglais

Partager via


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

Ordre de tri

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.