Listenfunktionen

Diese Funktionen erstellen und bearbeiten Listenwerte.

Informationen

Name	Beschreibung
List.Count	Gibt die Anzahl der Elemente in einer Liste zurück.
List.IsEmpty	Gibt true zurück, wenn die Liste leer ist.
List.NonNullCount	Gibt die Anzahl der Nicht-Null-Elemente in der Liste zurück.

Auswahl

Name	Beschreibung
List.Alternate	Gibt eine Liste zurück, die aus allen ungerade nummerierten Offsetelementen in einer Liste besteht.
List.Buffer	Puffert eine Liste.
List.Distinct	Gibt eine Liste von Werten zurück, bei der Duplikate entfernt wurden.
List.FindText	Gibt eine Liste von Werten (einschließlich Datensatzfeldern) zurück, die den angegebenen Text enthalten.
List.First	Gibt den ersten Wert der Liste oder den angegebenen Standardwert zurück, wenn leer.
List.FirstN	Gibt den ersten Satz von Elementen in der Liste zurück, indem angegeben wird, wie viele Elemente zurückgegeben werden sollen, oder eine qualifizierende Bedingung.
List.InsertRange	Fügt Werte in eine Liste im angegebenen Index ein.
List.IsDistinct	Gibt an, ob in der Liste Duplikate vorhanden sind.
List.Last	Gibt den letzten Wert der Liste oder den angegebenen Standardwert zurück, wenn leer.
List.LastN	Gibt den letzten Wert in der Liste zurück. Kann optional angeben, wie viele Werte zurückgegeben werden sollen, oder eine qualifizierende Bedingung.
List.MatchesAll	Gibt true zurück, wenn die Bedingungsfunktion von allen Werten in der Liste erfüllt ist.
List.MatchesAny	Gibt true zurück, wenn die Bedingungsfunktion mit einem beliebigen Wert erfüllt ist.
List.Positions	Gibt eine Liste von Offsets für die Eingabe zurück.
List.Range	Gibt eine Teilmenge der Liste zurück, die mit einem Offset beginnt.
List.Select	Gibt eine Liste von Werten zurück, die der Bedingung entsprechen.
List.Single	Gibt das einzige Listenelement für eine Liste mit einer Länge von 1 zurück, andernfalls wird eine Ausnahme ausgelöst.
List.SingleOrDefault	Gibt das einzelne Listenelement für eine Liste der Länge 1 zurück und den Standardwert, wenn die Liste leer ist.
List.Skip	Gibt eine Liste zurück, die die angegebene Anzahl von Elementen am Anfang der Liste überspringt.

Transformationsfunktionen

Name	Beschreibung
List.Accumulate	Akkumuliert einen summarischen Wert aus den Elementen der Liste.
List.Combine	Gibt eine einzelne Liste zurück, indem mehrere Listen kombiniert werden.
List.ConformToPageReader	Diese Funktion ist nur für die interne Verwendung vorgesehen.
List.RemoveFirstN	Gibt eine Liste zurück, die die angegebene Anzahl von Elementen am Anfang der Liste überspringt.
List.RemoveItems	Entfernt Elemente aus der ersten Liste, die in der zweiten Liste vorhanden sind.
List.RemoveLastN	Gibt eine Liste zurück, die die angegebene Anzahl von Elementen aus dem Ende der Liste entfernt.
List.RemoveMatchingItems	Entfernt alle Vorkommen der Eingabewerte.
List.RemoveNulls	Entfernt alle null Werte aus der angegebenen Liste.
List.RemoveRange	Entfernt die angegebene Anzahl von Werten ab der angegebenen Position.
List.Repeat	Gibt eine Liste zurück, die aus count Wiederholungen der ursprünglichen Liste besteht.
List.ReplaceMatchingItems	Ersetzt Vorkommen vorhandener Werte in der Liste durch neue Werte, die der Bedingung entsprechen.
List.ReplaceRange	Ersetzt die count-Anzahl von Werten ab position durch die Ersatzwerte.
List.ReplaceValue	Durchsucht eine Liste nach dem angegebenen Wert und ersetzt sie.
List.Reverse	Kehrt die Reihenfolge der Werte in der Liste um.
List.Split	Teilt die angegebene Liste mithilfe der angegebenen Seitengröße in eine Liste mit Listen auf.
List.Transform	Gibt eine neue Liste von Werten zurück, die aus dieser Liste berechnet werden.
List.TransformMany	Gibt eine Liste zurück, deren Elemente mithilfe der angegebenen Funktionen aus der Eingabeliste transformiert werden.
List.Zip	Gibt eine Liste von Listen zurück, indem Elemente an derselben Position in mehreren Listen kombiniert werden.

Mitgliedschaftsfunktionen

Da alle Werte auf Gleichheit getestet werden können, können diese Funktionen über heterogene Listen ausgeführt werden.

Name	Beschreibung
List.AllTrue	Gibt true zurück, wenn alle Ausdrücke wahr sind.
List.AnyTrue	Gibt „wahr“ zurück, wenn ein beliebiger Ausdruck zutrifft.
List.Contains	Gibt an, ob die Liste den Wert enthält.
List.ContainsAll	Gibt an, wo eine Liste alle Werte in einer anderen Liste enthält.
List.ContainsAny	Gibt an, wo eine Liste einen der Werte in einer anderen Liste enthält.
List.PositionOf	Gibt die Offsets eines Werts in einer Liste zurück.
List.PositionOfAny	Gibt den ersten Offset eines Werts in einer Liste zurück.

Festlegen von Vorgängen

Name	Beschreibung
List.Difference	Gibt die Differenz der beiden angegebenen Listen zurück.
List.Intersect	Gibt die Schnittmenge der In der Eingabe gefundenen Listenwerte zurück.
List.Union	Gibt die Union der Listenwerte zurück, die in der Eingabe gefunden wurden.

Bestellung

Sortierfunktionen führen Vergleiche durch. Alle verglichenen Werte müssen miteinander vergleichbar sein. Dies bedeutet, dass sie alle aus demselben Datentyp stammen müssen (oder null enthalten, was immer als das kleinste angesehen wird). Andernfalls wird Expression.Error ausgelöst.

Vergleichbare Datentypen umfassen:

• Zahl
• Dauer
• DateTime
• Text
• Logisch
• Null

Name	Beschreibung
List.Max	Gibt den Maximalwert oder den Standardwert für eine leere Liste zurück.
List.MaxN	Gibt den Maximalwert(n) in der Liste zurück. Die Anzahl der zurückzugebenden Werte oder eine Filterbedingung muss angegeben werden.
List.Median	Gibt den Medianwert in der Liste zurück.
List.Min	Gibt den Minimalwert oder den Standardwert für eine leere Liste zurück.
List.MinN	Gibt den mindestwert(n) in der Liste zurück. Die Anzahl der zurückzugebenden Werte oder eine Filterbedingung kann angegeben werden.
List.Sort	Sortiert eine Datenliste nach den angegebenen Kriterien.
List.Percentile	Gibt ein oder mehrere Stichproben-Quantile zurück, die den angegebenen Wahrscheinlichkeiten entsprechen.

Durchschnitte

Diese Funktionen funktionieren über homogene Listen von Zahlen, DateTimes und Durations.

Name	Beschreibung
List.Average	Gibt den Mittelwert der Werte zurück. Funktioniert mit Zahlen-, Datums-, Datetime-, Datetimezone- und Dauerwerten.
List.Mode	Gibt den häufigsten Wert in der Liste zurück.
List.Modes	Gibt eine Liste der am häufigsten verwendeten Werte in der Liste zurück.
List.StandardDeviation	Gibt eine stichprobenbasierte Schätzung der Standardabweichung zurück. Diese Funktion 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.

Ergänzung

Diese Funktionen funktionieren über homogene Listen von Zahlen oder Daueren.

Name	Beschreibung
List.Sum	Gibt die Summe der Elemente in der Liste zurück.

Ziffern

Diese Funktionen funktionieren nur über Zahlen.

Name	Beschreibung
List.Covariance	Gibt die Kovarianz zwischen den beiden Zahlenlisten zurück.
List.Product	Gibt das Produkt der Zahlen in der Liste zurück.

Generatoren

Diese Funktionen generieren eine Liste von Werten.

Name	Beschreibung
List.Dates	Generiert eine Liste der date Werte, die einem Anfangswert, einer Anzahl und einem inkrementellen Dauerwert entsprechen.
List.DateTimes	Generiert eine Liste der datetime Werte, die einem Anfangswert, einer Anzahl und einem inkrementellen Dauerwert entsprechen.
List.DateTimeZones	Generiert eine Liste der datetimezone Werte, die einem Anfangswert, einer Anzahl und einem inkrementellen Dauerwert entsprechen.
List.Durations	Generiert eine Liste der duration Werte, die einem Anfangswert, einer Anzahl und einem inkrementellen Dauerwert entsprechen.
List.Generate	Generiert eine Liste von Werten.
List.Numbers	Gibt eine Liste von Zahlen zurück, die einen Anfangswert, eine Anzahl und einen optionalen Inkrementwert angegeben haben.
List.Random	Gibt eine Liste von Zufallszahlen zurück.
List.Times	Generiert eine Liste der time Werte, die einem Anfangswert, einer Anzahl und einem inkrementellen Dauerwert entsprechen.

Parameterwerte

Vorkommnisspezifikation

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

Sortierreihenfolge

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

Gleichungskriterien

Formelkriterien für Listenwerte können als eine der folgenden Kriterien angegeben werden:

• Ein Funktionswert, der entweder lautet:
  • Eine Schlüsselauswahl, die den Wert in der Liste bestimmt, um die Gleichheitskriterien anzuwenden.
  • Eine Vergleichsfunktion, die zum Angeben der anzuwendenden Vergleichsart verwendet wird. Integrierte Vergleichsfunktionen können angegeben werden—Gehen Sie zu Vergleichsfunktionen.
• Ein Listenwert, der Folgendes hat:
  • Genau zwei Elemente.
  • Das erste Element ist der Schlüssel-Selektor, wie oben angegeben.
  • Das zweite Element ist ein Vergleichselement, wie oben angegeben.

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

Vergleichskriterien

Das Vergleichskriterium kann als eines der folgenden Werte angegeben werden:

• Ein Zahlenwert, der eine Sortierreihenfolge angibt. Für weitere Informationen gehen Sie zu Sortierreihenfolge.
• Zum Berechnen eines Schlüssels, der für die Sortierung verwendet werden soll, kann eine Funktion eines Arguments verwendet werden.
• Um sowohl einen Schlüssel als auch eine Kontrollreihenfolge auszuwählen, kann ein Vergleichskriterium eine Liste sein, die den Schlüssel und die Reihenfolge enthält.
• Um den Vergleich vollständig zu steuern, kann eine Funktion von zwei Argumenten verwendet werden, die -1, 0 oder 1 zurückgibt, wenn die Beziehung zwischen der linken und rechten Eingabe angegeben ist. Value.Compare ist eine Methode, die zum Delegieren 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 Vorkommen des alten Werts in der Liste ersetzen soll.