Listenfunktionen
Diese Funktionen erstellen und ändern Listenwerte.
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. |
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. |
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 projiziert werden. |
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. |
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. |
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 |
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. |
Diese Funktionen verarbeiten homogene Listen mit Zahlen oder Dauern.
Name | BESCHREIBUNG |
---|---|
List.Sum | Gibt die Summe aus einer Liste zurück. |
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. |
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. |
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
- Order.Ascending = 0;
- Order.Descending = 1;
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.
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 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.