Array-Funktionen

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.

recommendation-more-help

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

Beispiel:

Ein Array erhalten:

[{"name":"Bob", "age":22}, {"name":"Tim", "age":23}]

und Argumente

{{toCollection(6.array; "name"; "age")}}

Die Funktion gibt zurück

{
    "Bob": 22,
    "Tim": 23
}

toArray

Diese Funktion wandelt eine Sammlung in ein Array von Schlüssel-Wert-Paaren um.

Beispiele:

Angegeben an die Sammlung

{ key1: "value1", key2: "value2:}

Die Funktion

toArray({ key1: "value1", key2: "value2:})

Gibt das Array von Schlüssel-Wert-Paaren zurück.

[{ key1: "value1"}, { key2: "value2"}]

arrayDifference [array1, array2, mode]

Gibt die Differenz zwischen zwei Arrays zurück.

Geben Sie einen der folgenden Werte für den mode ein.

  • classic: Gibt ein neues Array zurück, das alle Elemente der array1 enthält, die nicht in array2 vorhanden sind.

  • symmetric: Gibt ein Array von Elementen zurück, die nicht in beiden Arrays enthalten sind.

    Mit anderen Worten: Die Funktion gibt ein -Array zurück, das alle Elemente von array1 enthält, die nicht in array2 vorhanden sind, sowie alle Elemente von array2, die nicht in array1 vorhanden sind.

Beispiele:

Bei den folgenden Arrays:

myArray = [1,2,3,4,5]
yourArray = [3,4,5,6,7]
  • arrayDifference [myArray, yourArray, classic]

    Gibt [1,2]

  • arrayDifference [yourArray, myArray, classic]

    Gibt [6,7]

  • arrayDifference [myArray, yourArray, symmetric]

    Gibt [1,2,6,7]

deduplizieren

Schlüsselwörter

emptyarray

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3