Funzioni array, list e set
Profile Query Language (PQL) offre funzioni che semplificano l'interazione con array, elenchi e stringhe. Ulteriori informazioni sulle altre funzioni di PQL sono disponibili nella Profile Query Language panoramica.
In entrata
La funzione in viene utilizzata per determinare se un elemento è membro di un array o di un elenco come booleano.
Formato
{VALUE} in {ARRAY}
Esempio
La seguente query PQL definisce le persone il cui compleanno cade in marzo, giugno o settembre.
person.birthMonth in [3, 6, 9]
Non in
La funzione notIn viene utilizzata per determinare se un elemento non è un membro di un array o di un elenco come booleano.
NOTEnotIn also assicura che nessuno dei due valori sia uguale a null. Pertanto, i risultati non sono una negazione esatta della funzione in.Formato
{VALUE} notIn {ARRAY}
Esempio
La seguente query PQL definisce gli utenti con compleanni che non sono in marzo, giugno o settembre.
person.birthMonth notIn [3, 6, 9]
Interseca
La funzione intersects viene utilizzata per determinare se due matrici o elenchi hanno almeno un membro comune come booleano.
Formato
{ARRAY}.intersects({ARRAY})
Esempio
La seguente query PQL definisce gli utenti i cui colori preferiti includono almeno uno rosso, blu o verde.
person.favoriteColors.intersects(["red", "blue", "green"])
Intersezione
La funzione intersection viene utilizzata per determinare i membri comuni di due array o elenchi come elenco.
Formato
{ARRAY}.intersection({ARRAY})
Esempio
La seguente query PQL definisce se la persona 1 e la persona 2 hanno entrambi i colori preferiti rosso, blu e verde.
person1.favoriteColors.intersection(person2.favoriteColors) = ["red", "blue", "green"]
Sottoinsieme di
La funzione subsetOf viene utilizzata per determinare se un array specifico (array A) è un sottoinsieme di un altro array (array B). In altre parole, che tutti gli elementi nell’array A sono elementi dell’array B come booleano.
Formato
{ARRAY}.subsetOf({ARRAY})
Esempio
La seguente query PQL definisce le persone che hanno visitato tutte le loro città preferite.
person.favoriteCities.subsetOf(person.visitedCities)
Superset di
La funzione supersetOf viene utilizzata per determinare se un array specifico (array A) è un superset di un altro array (array B). In altre parole, l’array A contiene tutti gli elementi dell’array B come booleano.
Formato
{ARRAY}.supersetOf({ARRAY})
Esempio
La seguente query PQL definisce le persone che hanno mangiato sushi e pizza almeno una volta.
person.eatenFoods.supersetOf(["sushi", "pizza"])
Include
La funzione includes viene utilizzata per determinare se un array o un elenco contiene un dato elemento come booleano.
Formato
{ARRAY}.includes({ITEM})
Esempio
La seguente query PQL definisce gli utenti il cui colore preferito include il rosso.
person.favoriteColors.includes("red")