Listenfunktionen - PowerQuery M (2024)

Artikel
04/06/2023

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 `countOrCondition`Parameter 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 `countOrCondition`Parameter 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 proji*ziert 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 Liste1, die nicht in Liste2 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 hom*ogene 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 hom*ogene 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

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

Sortierreihenfolge

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

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üsselselektorwie 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.