Show Menu
THEMEN×

Array-, Liste- und Set-Funktionen

PQL-Angebote (Profil Abfrage Language) erleichtern die Interaktion mit Arrays, Listen und Zeichenfolgen. Weitere Informationen zu anderen PQL-Funktionen finden Sie in der Profil Abfrage Language-Übersicht .

Mit

Mit der in Funktion wird bestimmt, ob ein Element Mitglied eines Arrays oder einer Liste ist.
Format
{VALUE} in {ARRAY}

Beispiel
Die folgende PQL-Abfrage definiert Personen mit Geburtstagen im März, Juni oder September.
person.birthMonth in [3, 6, 9]

Not in

Mit der notIn Funktion wird bestimmt, ob ein Element kein Mitglied eines Arrays oder einer Liste ist.
Die notIn Funktion stellt auch sicher, dass keiner der Werte null ist. Die Ergebnisse sind daher keine exakte Negation der in Funktion.
Format
{VALUE} notIn {ARRAY}

Beispiel
Die folgende PQL-Abfrage definiert Personen mit Geburtstagen, die nicht im März, Juni oder September leben.
person.birthMonth notIn [3, 6, 9]

Intersekten

Mit der intersects Funktion wird bestimmt, ob zwei Arrays oder Listen mindestens ein gemeinsames Mitglied haben.
Format
{ARRAY}.intersects({ARRAY})

Beispiel
Die folgende PQL-Abfrage definiert Personen, deren Lieblingsfarben mindestens eine Farbe Rot, Blau oder Grün enthalten.
person.favoriteColors.intersects(["red", "blue", "green"])

Schnittmenge

Die intersection Funktion dient zur Bestimmung der gemeinsamen Elemente von zwei Arrays oder Listen.
Format
{ARRAY}.intersection({ARRAY})

Beispiel
Die folgende PQL-Abfrage definiert, ob die Farben Rot, Blau und Grün von Person 1 und Person 2 jeweils am liebsten sind.
person1.favoriteColors.intersection(person2.favoriteColors) = ["red", "blue", "green"]

Untergruppe von

Mit der subsetOf Funktion wird bestimmt, ob ein bestimmtes Array (Array A) eine Untergruppe eines anderen Arrays (Array B) ist. Anders ausgedrückt, dass alle Elemente im Array A Elemente des Arrays B sind.
Format
{ARRAY}.subsetOf({ARRAY})

Beispiel
Die folgende PQL-Abfrage definiert Personen, die alle ihre Lieblingsstädte besucht haben.
person.favoriteCities.subsetOf(person.visitedCities)

Superset

Mit der supersetOf Funktion wird bestimmt, ob ein bestimmtes Array (Array A) eine Übermenge eines anderen Arrays (Array B) ist. Mit anderen Worten, dieses Array A enthält alle Elemente im Array B.
Format
{ARRAY}.supersetOf({ARRAY})

Beispiel
Die folgende PQL-Abfrage definiert Personen, die mindestens einmal Sushi und Pizza gegessen haben.
person.eatenFoods.supersetOf(["sushi", "pizza"])

Enthält

Mit der includes Funktion wird bestimmt, ob ein Array oder eine Liste ein bestimmtes Element enthält.
Format
{ARRAY}.includes({ITEM})

Beispiel
Die folgende PQL-Abfrage definiert Personen, deren Lieblingsfarbe Rot enthält.
person.favoriteColors.includes("red")

Unterscheiden

Die distinct Funktion wird verwendet, um Duplikat-Werte aus einem Array oder einer Liste zu entfernen.
Format
{ARRAY}.distinct()

Beispiel
Die folgende PQL-Abfrage gibt Personen an, die Bestellungen in mehr als einem Store aufgegeben haben.
person.orders.storeId.distinct().count() > 1

Gruppe nach

Die groupBy Funktion wird verwendet, um die Werte eines Arrays oder einer Liste basierend auf dem Wert des Ausdrucks in eine Gruppe zu unterteilen.
Format
{ARRAY}.groupBy({EXPRESSION)

Argument
Beschreibung
{ARRAY}
Das zu gruppierende Array oder die zu gruppierende Liste.
{EXPRESSION}
Ein Ausdruck, der jedes Element im zurückgegebenen Array oder in der zurückgegebenen Liste zuordnet.
Beispiel
Die folgende PQL-Abfrage gruppiert alle Bestellungen, bei denen die Bestellung gespeichert wurde.
orders.groupBy(storeId)

Filter

Die filter Funktion wird zum Filtern eines Arrays oder einer Liste auf der Grundlage eines Ausdrucks verwendet.
Format
{ARRAY}.filter({EXPRESSION})

Argument
Beschreibung
{ARRAY}
Das zu filternde Array oder die zu filternde Liste.
{EXPRESSION}
Ein Ausdruck, nach dem gefiltert werden soll.
Beispiel
Die folgende PQL-Abfrage definiert alle Personen ab 21 Jahren.
person.filter(age >= 21)

Landkarte

Die map Funktion wird verwendet, um ein neues Array zu erstellen, indem auf jedes Element in einem Array ein Ausdruck angewendet wird.
Format
array.map(expression)

Beispiel
Mit der folgenden PQL-Abfrage wird ein neues Zahlenarray erstellt und der Wert der Originalzahlen quadriert.
numbers.map(square)

Erste n im Array

Die topN Funktion gibt die ersten N Elemente in einem Array zurück, wenn sie in aufsteigender Reihenfolge nach dem angegebenen numerischen Ausdruck sortiert werden.
Format
{ARRAY}.topN({VALUE}, {AMOUNT})

Argument
Beschreibung
{ARRAY}
Das zu sortierende Array oder die zu sortierende Liste.
{VALUE}
Die Eigenschaft, in der das Array oder die Liste sortiert werden soll.
{AMOUNT}
Die Anzahl der zurückzugebenden Elemente.
Beispiel
Die folgende PQL-Abfrage gibt die fünf wichtigsten Bestellungen mit dem höchsten Preis zurück.
orders.topN(price, 5)

Letzte n im Array

Die bottomN Funktion gibt die letzten N Elemente in einem Array zurück, wenn sie in aufsteigender Reihenfolge nach dem angegebenen numerischen Ausdruck sortiert werden.
Format
{ARRAY}.bottomN({VALUE}, {AMOUNT})

Argument
Beschreibung
{ARRAY}
Das zu sortierende Array oder die zu sortierende Liste.
{VALUE}
Die Eigenschaft, in der das Array oder die Liste sortiert werden soll.
{AMOUNT}
Die Anzahl der zurückzugebenden Elemente.
Beispiel
Die folgende PQL-Abfrage gibt die fünf wichtigsten Bestellungen mit dem niedrigsten Preis zurück.
orders.bottomN(price, 5)

Erster Posten

Mit der head Funktion wird das erste Element im Array oder in der Liste zurückgegeben.
Format
{ARRAY}.head()

Beispiel
Die folgende PQL-Abfrage gibt die erste der fünf Top-Bestellungen mit dem höchsten Preis zurück. Weitere Informationen zur topN Funktion finden Sie im ersten Abschnitt .
orders.topN(price, 5).head()

Nächste Schritte

Nachdem Sie nun Informationen zu Array-, Liste- und Set-Funktionen erhalten haben, können Sie diese in Ihren PQL-Abfragen verwenden. Weitere Informationen zu anderen PQL-Funktionen finden Sie in der Profil Abfrage Language-Übersicht .