Fonctions de liste et de tableau

Utilisez ces fonctions pour faciliter l'interaction avec des tableaux, des listes et des chaînes.

Nombre uniquement nul

La fonction countOnlyNull sert à compter le nombre de valeurs nulles dans une liste.

Syntaxe

{%= countOnlyNull(array) %}

Exemple

{%= countOnlyNull([4,0,1,6,0,0]) %}

Renvoie 3.

Nombre avec nul

La fonction countWithNull est utilisée pour compter tous les éléments d’une liste, y compris les valeurs nulles.

Syntaxe

{%= countWithNull(array) %}

Exemple

{%= countOnlyNull([4,0,1,6,0,0]) %}

Renvoie 6.

Distinct

La fonction distinct est utilisée pour obtenir les valeurs d'un tableau ou d'une liste dont les valeurs en double sont supprimées.

Syntaxe

{%= distinct(array) %}

Exemple

L'opération suivante définit les personnes qui ont passé des commandes dans plusieurs magasins.

{%= distinct(person.orders.storeId).count() > 1 %}

Nombre distinct avec nul

La fonction distinctCountWithNull sert à compter le nombre de valeurs différentes dans une liste, y compris les valeurs nulles.

Syntaxe

{%= distinctCountWithNull(array) %}

Exemple

{%= distinctCountWithNull([10,2,10,null]) %}

Renvoie 3.

Premier élément

La fonction head est utilisée pour renvoyer le premier élément dans un tableau ou une liste.

Syntaxe

{%= head(array) %}

Exemple

L'opération suivante renvoie la première des cinq principales commandes au prix le plus élevé. Vous trouverez plus d'informations sur la fonction topN dans la section First n in array.

{%= head(topN(orders,price, 5)) %}

n premiers éléments d’un tableau

La fonction topN est utilisée pour renvoyer les premiers éléments N d’un tableau, lorsqu’ils sont triés dans l’ordre croissant en fonction d’une expression numérique donnée.

Syntaxe

{%= topN(array, value, amount) %}

Exemple

L’opération suivante renvoie les cinq premières commandes au prix le plus bas.

{%= topN(orders,price, 5) %}

Dans

La fonction in permet de déterminer si un élément est un membre d'un tableau ou d'une liste.

Syntaxe

{%= in(value, array) %}

Exemple

L'opération suivante définit les personnes dont l'anniversaire est en mars, juin ou septembre.

{%= in (person.birthMonth, [3, 6, 9]) %}

Inclut

La fonction includes permet de déterminer si un tableau ou une liste contient un élément donné.

Syntaxe

{%= includes(array,item) %}

Exemple

L'opération suivante définit les personnes dont le rouge est l'une des couleurs préférées.

{%= includes(person.favoriteColors,"red") %}

Intersections

La fonction intersects permet de déterminer si deux tableaux ou deux listes ont au moins un membre commun.

Syntaxe

{%= intersects(array1, array2) %}

Exemple

L'opération suivante définit les personnes dont les couleurs préférées comprennent au moins le rouge, le bleu ou le vert.

{%= intersects(person.favoriteColors,["red", "blue", "green"]) %}

n derniers éléments d’un tableau

La fonction bottomN est utilisée pour renvoyer les derniers éléments N d’un tableau, lorsqu’ils sont triés dans l’ordre croissant en fonction d’une expression numérique donnée.

Syntaxe

{%= bottomN(array, value, amount) %}

Exemple

L’opération suivante renvoie les cinq dernières commandes au prix le plus élevé.

{%= bottomN(orders,price, 5) %}

Pas dans

La fonction notIn permet de déterminer si un élément n'est pas un membre d'un tableau ou d'une liste.

Syntaxe

{%= notIn(value, array) %}

Exemple

L'opération suivante définit les personnes dont l'anniversaire n'est ni en mars, ni en juin, ni en septembre.

{%= notIn(person.birthMonth ,[3, 6, 9]) %}

Sous-ensemble de

La fonction subsetOf sert à déterminer si un tableau spécifique (tableau A) est un sous-ensemble d'un autre tableau (tableau B). En d'autres termes, elle permet de déterminer si tous les éléments du tableau A sont des éléments du tableau B.

Syntaxe

{%= subsetOf(array1, array2) %}

Exemple

L'opération suivante définit les personnes qui ont visité toutes leurs villes préférées.

{%= subsetOf(person.favoriteCities,person.visitedCities) %}

Sur-ensemble de

La fonction supersetOf sert à déterminer si un tableau spécifique (tableau A) est un sur-ensemble d'un autre tableau (tableau B). En d'autres termes, elle permet de déterminer si le tableau A contient tous les éléments du tableau B.

Syntaxe

{%= supersetOf(array1, array2) %}

Exemple

L'opération suivante définit les personnes qui ont mangé des sushis et de la pizza au moins une fois.

{%= supersetOf(person.eatenFoods,["sushi", "pizza"] %}