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.

Format

{%= 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.

Format

{%= 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.

Format

{%= 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.

Format

{%= distinctCountWithNull(array) %}

Exemple

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

Renvoie 3.

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

Format

{%= 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.

Format

{%= topN(array, value, amount) %}
Argument Description
{ARRAY} Tableau ou liste à trier.
{VALUE} Propriété dans laquelle trier le tableau ou la liste.
{AMOUNT} Nombre d'éléments à renvoyer.

Exemple

L'opération suivante renvoie les cinq principales commandes au prix le plus élevé.

{%= 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.

Format

{%= 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é.

Format

{%= 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.

Format

{%= 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.

Format

{%= bottomN(array, value, amount) %}
Argument Description
{ARRAY} Tableau ou liste à trier.
{VALUE} Propriété dans laquelle trier le tableau ou la liste.
{AMOUNT} Nombre d'éléments à renvoyer.

Exemple

L'opération suivante renvoie les cinq principales commandes au prix le plus bas.

{%= 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.

REMARQUE

La fonction notIn assure également qu'aucune valeur n'est nulle. Par conséquent, les résultats ne sont pas une négation exacte de la fonction in.

Format

{%= 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.

Format

{%= 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.

Format

{%= 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"] %}

Sur cette page