Array-Funktionen

Letzte Aktualisierung: 21. April 2025
  • Themen:

Join (Array;Trennzeichen)

Verkettet alle Elemente eines Arrays in einer Zeichenfolge, wobei zwischen den einzelnen Elementen das angegebene Trennzeichen verwendet wird.

length (Array)

Gibt die Anzahl der Elemente in einem Array zurück.

keys (Objekt)

Gibt ein Array der Eigenschaften eines bestimmten Objekts oder Arrays zurück.

slice (Array; Start; [end])

Gibt ein neues Array zurück, das nur ausgewählte Elemente enthält.

Zusammenführen (Array1; Array2; …)

Führt ein oder mehrere Arrays in einem Array zusammen.

Enthält (Array; Wert)

Prüft, ob ein Array den Wert enthält.

Entfernen (Array; Wert1; Wert2; …)

Entfernt die in den Parametern eines Arrays angegebenen Werte. Diese Funktion ist nur bei primitiven Text- oder Zahlenfeldern wirksam.

add (Array; Wert1; Wert2; …)

Fügt die in den Parametern angegebenen Werte zu einem Array hinzu und gibt dieses Array zurück.

Map (komplexes Array; Schlüssel; [Schlüssel zum Filtern]; [mögliche Werte zum Filtern])

Gibt ein primitives Array mit Werten eines komplexen Arrays zurück. Diese Funktion ermöglicht das Filtern von Werten. Verwenden Sie unformatierte Variablennamen für Schlüssel.

Beispiele:

  • map(Emails[];email)

    Gibt ein primitives Array mit E-Mails zurück.

  • map(Emails[];email;label;work;home)

    Gibt ein primitives Array mit E-Mails mit einer Kennzeichnung wie Arbeit oder Startseite zurück.

Weitere Informationen finden Sie unter Zuordnen eines Arrays oder Array-Elements.

schlurfen

sort (Array; [order]; [key])

Sortiert die Werte eines Arrays. Die gültigen Werte des order sind:

  • asc

    (Standard) - aufsteigende Reihenfolge: 1, 2, 3, … für Typ Nummer. A, B, C, a, b, c, … für den Typ Text

  • desc

    Absteigende Reihenfolge: …, 3, 2, 1 für Typ Nummer. …, c, b, a, C, B, A für den Typ Text.

  • asc ci

    Aufsteigende Reihenfolge ohne Unterscheidung der Groß- und Kleinschreibung: A, a, B, b, C, c, … für den Typ Text.

  • desc ci

    Groß-/Kleinschreibung wird nicht in absteigender Reihenfolge beachtet: …, C, c, B, b, A, a für Typ Text.

Verwenden Sie den key-Parameter, um auf Eigenschaften in komplexen Objekten zuzugreifen.

Verwenden Sie unformatierte Variablennamen für Schlüssel.

Verwenden Sie Punktnotation, um auf verschachtelte Eigenschaften zuzugreifen.

Das erste Element in einem Array ist Index 1.

Beispiele:

  • sort(Contacts[];name)

    Sortiert ein Array von Kontakten nach der Eigenschaft „name“ in aufsteigender Standardreihenfolge.

  • sort(Contacts[];desc;name)

    Sortiert ein Array von Kontakten nach der Eigenschaft „name“ in absteigender Reihenfolge

  • sort(Contacts[];asc ci;name)

    Sortiert ein Array von Kontakten nach der Eigenschaft „name“ in aufsteigender Reihenfolge ohne Berücksichtigung der Groß-/Kleinschreibung

  • sort(Emails[];sender.name)

    Sortiert ein Array von E-Mails nach der Eigenschaft „sender.name“

reverse (Array)

Das erste Element des Arrays wird zum letzten Element, das zweite zum vorletzten Element usw.

reduzieren (Array)

Erstellt ein neues Array, in dem alle Unterarray-Elemente rekursiv bis zur angegebenen Tiefe verkettet sind.

distinct (Array; [key])

Entfernt Duplikate innerhalb eines Arrays. Verwenden Sie das key-Argument, um auf Eigenschaften in komplexen Objekten zuzugreifen. Verwenden Sie Punktnotation, um auf verschachtelte Eigenschaften zuzugreifen. Das erste Element in einem Array ist Index 1.

Beispiel: distinct(Contacts[];name)

Entfernt Duplikate innerhalb eines Arrays von Kontakten, indem die Eigenschaft „name“ verglichen wird.

toCollection

  • Diese Funktion wandelt ein Array, das Schlüssel-Wert-Paare enthält, in eine Sammlung um. Die Funktion umfasst drei Argumente:

  • (Array) enthält Schlüssel-Wert-Paare

  • (String) Der Name des als Schlüssel zu verwendenden Felds

  • (Zeichenfolge) Der Name des als Wert zu verwendenden Felds