Freigeben über

Listenfunktionen

  • Artikel

Diese Funktionen erstellen und ändern Listenwerte.

Information

Name Beschreibung
List.Count Gibt die Anzahl der Elemente in einer Liste zurück.
List.NonNullCount Gibt die Anzahl der Elemente in einer Liste ohne NULL-Werte zurück.
List.IsEmpty Gibt zurück, ob eine Liste leer ist.

Auswahl

Name Beschreibung
List.Alternate Gibt eine Liste mit den Elementen zurück, die auf Basis einer Anzahl, eines optionalen Wiederholungsintervalls und eines optionalen Offsets von der ursprünglichen Liste abweichen.
List.Buffer Puffert die Liste im Arbeitsspeicher. Das Ergebnis dieses Aufrufs ist eine stabile Liste, d. h., die Liste verfügt über eine deterministische Anzahl und Reihenfolge von Elementen.
List.Distinct Filtert eine Liste, indem Duplikate entfernt werden. Zum Steuern des Übereinstimmungsvergleichs kann ein optionales Gleichungskriterium angegeben werden. Dabei wird jeweils der erste Wert der einzelnen Gleichheitsgruppen ausgewählt.
List.FindText Durchsucht eine Liste von Werten, einschließlich der Datensatzfelder, nach einem Textwert.
List.First Gibt den ersten Wert der Liste zurück. Ist die Liste leer, wird der angegebene Standardwert zurückgegeben. Gibt das erste Element in der Liste zurück. Ist die Liste leer, wird der optionale Standardwert zurückgegeben. Wenn die Liste leer ist und kein Standardwert angegeben wurde, kehrt die Funktion zurück.
List.FirstN Gibt die erste Gruppe von Elementen in der Liste zurück. Hierzu wird durch countOrCondition die zurückzugebende Anzahl von Elementen oder eine qualifizierende Bedingung angegeben.
List.InsertRange Fügt Elemente aus Werten am angegebenen Index in der Eingabeliste ein.
List.IsDistinct Gibt zurück, ob eine Liste eindeutig ist.
List.Last Gibt die letzte Gruppe von Elementen in der Liste zurück. Hierzu wird durch countOrCondition die zurückzugebende Anzahl von Elementen oder eine qualifizierende Bedingung angegeben.
List.LastN Gibt die letzte Gruppe von Elementen in einer Liste zurück. Hierzu wird entweder die zurückzugebende Anzahl oder eine qualifizierende Bedingung angegeben.
List.MatchesAll Gibt „true“ zurück, wenn alle Elemente in einer Liste eine Bedingung erfüllen.
List.MatchesAny Gibt „true“ zurück, wenn ein Element in einer Liste eine Bedingung erfüllt.
List.Positions Gibt eine Liste von Positionen für eine Eingabeliste zurück.
List.Range Gibt beginnend bei einem Offset eine Anzahl von Elementen zurück.
List.Select Wählt die Elemente aus, die einer Bedingung entsprechen.
List.Single Gibt das einzige Element einer Liste zurück oder gibt einen Expression.Error zurück, wenn die Liste mehrere Elemente enthält.
List.SingleOrDefault Gibt ein einzelnes Element aus einer Liste zurück.
List.Skip Überspringt das erste Element der Liste. Bei einer leeren Liste wird eine leere Liste zurückgegeben. Diese Funktion benötigt einen optionalen Parameter countOrCondition, um das Überspringen mehrerer Werte zu unterstützen.

Transformationsfunktionen

Name Beschreibung
List.Accumulate Akkumuliert ein Ergebnis aus der Liste. Diese Funktion wendet beginnend mit dem Ausgangswert-Seed die Akkumulatorfunktion an und gibt das Endergebnis zurück.
List.Combine Führt eine Liste von Listen in einer einzigen Liste zusammen.
List.ConformToPageReader Diese Funktion ist nur für die interne Verwendung vorgesehen.
List.RemoveRange Gibt eine Liste zurück, die beginnend mit einem Offset eine Anzahl von Elementen entfernt. Die Standardanzahl ist 1.
List.RemoveFirstN Gibt eine Liste zurück, bei der die angegebene Anzahl von Elementen beginnend mit dem ersten Element aus der Liste entfernt wurde. Die Anzahl der entfernten Elemente hängt vom optionalen countOrConditionParameter ab.
List.RemoveItems Entfernt Elemente aus list1, die in list2 vorhanden sind, und gibt eine neue Liste zurück.
List.RemoveLastN Gibt eine Liste zurück, bei der die angegebene Anzahl von Elementen beginnend mit dem letzten Element aus der Liste entfernt wurde. Die Anzahl der entfernten Elemente hängt vom optionalen countOrConditionParameter ab.
List.Repeat Gibt eine Liste zurück, die den Inhalt einer Eingabeliste eine angegebene Anzahl von Malen wiederholt.
List.ReplaceRange Gibt eine Liste zurück, die Zählwerte in einer Liste durch eine replaceWith Liste ersetzt, welche bei einem Index beginnt.
List.RemoveMatchingItems Entfernt alle Vorkommen der angegebenen Werte in der Liste.
List.RemoveNulls Entfernt NULL-Werte aus einer Liste.
List.ReplaceMatchingItems Ersetzt die Vorkommen vorhandener Werte in der Liste unter Verwendung der bereitgestellten equationCriteria durch neue Werte. Alte und neue Werte werden durch die replacements Parameter bereitgestellt. Um Übereinstimmungsvergleiche zu steuern, kann ein optionaler Gleichungskriterienwert angegeben werden. Ausführliche Informationen zu Ersetzungsvorgängen und Gleichungskriterien finden Sie unter Parameterwerte.
List.ReplaceValue Durchsucht eine Liste von Werten nach dem Wert und ersetzt jedes Vorkommen durch den Ersatzwert.
List.Reverse Gibt eine Liste zurück, in der die Elemente in einer Liste umgekehrt werden.
List.Split Unterteilt die angegebene Liste anhand der angegebenen Seitengröße in eine Liste von Listen.
List.Transform Führt die Funktion für jedes Element in der Liste aus und gibt die neue Liste zurück.
List.TransformMany Gibt eine Liste zurück, deren Elemente aus der Eingabeliste projiziert werden.

Mitgliedschaftsfunktionen

Da alle Werte auf Gleichheit geprüft werden können, können diese Funktionen mit heterogenen Listen arbeiten.

Name BESCHREIBUNG
List.AllTrue Gibt „true“ zurück, wenn alle Ausdrücke in einer Liste zutreffen.
List.AnyTrue Gibt „true“ zurück, wenn ein beliebiger Ausdruck in einer Liste zutrifft.
List.Contains Gibt „true“ zurück, wenn ein Wert in einer Liste gefunden wird.
List.ContainsAll Gibt „true“ zurück, wenn alle Elemente in Werten in einer Liste gefunden werden.
List.ContainsAny Gibt „true“ zurück, wenn ein Element in Werten in einer Liste gefunden wird.
List.PositionOf Sucht das erste Vorkommen eines Werts in einer Liste und gibt seine Position zurück.
List.PositionOfAny Sucht das erste Vorkommen eines Werts in Werten und gibt seine Position zurück.

Festlegungsvorgänge (Set operations)

Name BESCHREIBUNG
List.Difference Ermittelt die Elemente in Liste 1, die nicht in Liste 2 enthalten sind. Doppelte Werte werden unterstützt.
List.Intersect Gibt eine Liste aus einer Liste von Listen zurück und bildet die Schnittmenge aus den gemeinsamen Elementen in den einzelnen Listen. Doppelte Werte werden unterstützt.
List.Union Gibt eine Liste aus einer Liste von Listen zurück und vereinigt die Elemente in den einzelnen Listen. Die zurückgegebene Liste enthält alle Elemente in allen Eingabelisten. Doppelte Werte werden als Teil der Vereinigung abgeglichen.
List.Zip Gibt eine Liste von Listen zurück, indem Elemente an derselben Position kombiniert werden.

Sortieren

Sortierungsfunktionen führen Vergleiche aus. Alle verglichenen Werte müssen miteinander vergleichbar sein. Sie müssen also alle vom gleichen Datentyp stammen (oder NULL enthalten, das beim Vergleich immer den kleinsten Wert darstellt). Andernfalls wird eine Expression.Error ausgelöst.

Vergleichbare Datentypen beinhalten:

  • Zahl
  • Duration
  • Datetime
  • Text
  • Logisch
  • Null
Name BESCHREIBUNG
List.Max Gibt das maximale Element in einer Liste zurück. Ist die Liste leer, wird der optionale Standardwert zurückgegeben.
List.MaxN Gibt die maximalen Werte in der Liste zurück. Die Anzahl der zurückzugebenden Werte oder eine Filterbedingung muss angegeben werden.
List.Median Gibt das Median-Element aus einer Liste zurück.
List.Min Gibt das minimale Element in einer Liste zurück. Ist die Liste leer, wird der optionale Standardwert zurückgegeben.
List.MinN Gibt die minimalen Werte in einer Liste zurück. Die Anzahl der zurückzugebenden Werte oder eine Filterbedingung kann angegeben werden.
List.Sort Gibt eine mithilfe des Vergleichskriteriums sortierte Liste zurück.
List.Percentile Gibt mindestens ein Beispielperzentil zurück, das den angegebenen Wahrscheinlichkeiten entspricht

Durchschnittswerte (Averages)

Diese Funktionen verarbeiten homogene Listen von Zahlen, Datum/Uhrzeit-Angaben und Dauern.

Name BESCHREIBUNG
List.Average Gibt einen durchschnittlichen Wert aus einer Liste im Datentyp der Werte in der Liste zurück.
List.Mode Gibt ein Element zurück, das am häufigsten in einer Liste vorkommt.
List.Modes Gibt alle Elemente zurück, die mit der gleichen maximalen Häufigkeit vorkommen.
List.StandardDeviation Gibt die Standardabweichung aus einer Liste von Werten zurück. List.StandardDeviation führt eine stichprobenbasierte Schätzung aus. Das Ergebnis ist eine Zahl für Zahlen und eine Dauer für Datum/Uhrzeit-Angaben und Dauern.

Addition

Diese Funktionen verarbeiten homogene Listen mit Zahlen oder Dauern.

Name BESCHREIBUNG
List.Sum Gibt die Summe aus einer Liste zurück.

Numerische Werte (Numerics)

Diese Funktionen verarbeiten nur Zahlen.

Name BESCHREIBUNG
List.Covariance Gibt die Kovarianz zweier Listen als Zahl zurück.
List.Product Gibt das Produkt aus einer Liste von Zahlen zurück.

Generatoren

Diese Funktionen generieren eine Liste von Werten.

Name BESCHREIBUNG
List.Dates Gibt eine Liste von Datumswerten aus der Größenzählung zurück. Dabei wird am Anfang begonnen und jedem Wert ein Inkrement hinzugefügt.
List.DateTimes Gibt eine Liste von DateTime-Werten aus der Größenzählung zurück. Dabei wird am Anfang begonnen und jedem Wert ein Inkrement hinzugefügt.
List.DateTimeZones Gibt eine Liste von DateTimeZone-Werten aus der Größenzählung zurück. Dabei wird am Anfang begonnen und jedem Wert ein Inkrement hinzugefügt.
List.Durations Gibt eine Liste von Dauer-Werten aus der Größenzählung zurück. Dabei wird am Anfang begonnen und jedem Wert ein Inkrement hinzugefügt.
List.Generate Generiert eine Liste von Werten.
List.Numbers Gibt eine Liste von Zahlen aus der Größenzählung zurück. Dabei wird am Anfang begonnen und ein Inkrement hinzugefügt. Der Inkrementwert ist standardmäßig 1.
List.Random Gibt eine Liste zufälliger Zählerzahlen mit einem optionalen Seed-Parameter zurück.
List.Times Gibt eine Liste von Uhrzeitwerten der Größenzählung zurück. Dabei wird am Anfang begonnen.

Parameterwerte

Angabe des Vorkommens

Sortierreihenfolge

Gleichungskriterien

Die Gleichungskriterien für Listenwerte können angegeben werden als:

  • Ein Funktionswert, der entweder:
    • Ein Schlüsselselektor ist, der den Wert in der Liste zum Anwenden der Gleichheitskriterien bestimmt, oder
    • Eine Vergleichsfunktion darstellt, mit der die Art des anzuwendenden Vergleichs angegeben wird. Integrierte Vergleichsfunktionen können angegeben werden—Gehen Sie zu Vergleichsfunktionen.
  • Ein Listenwert, der:
    • Genau zwei Elemente aufweist.
    • Das erste Element ist der Schlüsselselektor wie oben angegeben.
    • Das zweite Element ist eine Vergleichsfunktion – wie oben angegeben.

Für weitere Informationen und Beispiele gehen Sie zu List.Distinct.

Vergleichskriterien

Als Vergleichskriterium kann einer der folgenden Werte angegeben werden:

  • Ein Zahlenwert, der eine Sortierreihenfolge angibt. Für weitere Informationen gehen Sie zu Sortierreihenfolge.
  • Zum Berechnen eines Schlüssels für die Sortierung kann eine Funktion aus einem einzigen Argument verwendet werden.
  • Um sowohl einen Schlüssel auszuwählen als auch die Reihenfolge zu steuern, kann das Vergleichskriterium als Liste mit Schlüssel und Reihenfolge angegeben werden.
  • Zur vollständigen Steuerung des Vergleichs kann eine Funktion mit zwei Argumenten verwendet werden, die abhängig von der Beziehung zwischen der linken und rechten Eingabe -1, 0 oder 1 zurückgibt. Value.Compare ist eine Methode, die zur Übertragung dieser Logik verwendet werden kann.

Für weitere Informationen und Beispiele gehen Sie zu List.Sort.

Ersetzungsvorgänge

Ersetzungsvorgänge werden durch einen Listenwert angegeben. Jedes Element dieser Liste muss Folgendes sein:

  • Ein Listenwert aus genau zwei Elementen.
  • Das erste Element ist der alte Wert in der Liste, der ersetzt werden soll.
  • Das zweite Element ist der neue Wert, der alle alten Werte ersetzen soll, die in der Liste auftreten.