Arrayer och listfunktioner arrays
Använd de här funktionerna för att underlätta interaktionen med arrayer, listor och strängar.
Endast antal null count-only-null
Funktionen countOnlyNull används för att räkna antalet null-värden i en lista.
Syntax
{%= countOnlyNull(array) %}
Exempel
{%= countOnlyNull([4,0,1,6,0,0]) %}
Returnerar 3.
Antal med null count-with-null
Funktionen countWithNull används för att räkna alla element i en lista inklusive null-värden.
Syntax
{%= countWithNull(array) %}
Exempel
{%= countOnlyNull([4,0,1,6,0,0]) %}
Returnerar 6.
Distinkt distinct
Funktionen distinct används för att hämta värden från en array eller lista där dubblettvärden har tagits bort.
Syntax
{%= distinct(array) %}
Exempel
Följande åtgärd anger personer som har gjort beställningar i mer än en butik.
{%= distinct(person.orders.storeId).count() > 1 %}
Distinkt antal med null distinct-count-with-null
Funktionen distinctCountWithNull används för att räkna antalet olika värden i en lista inklusive null-värden.
Syntax
{%= distinctCountWithNull(array) %}
Exempel
{%= distinctCountWithNull([10,2,10,null]) %}
Returnerar 3.
Första objektet head
Funktionen head används för att returnera det första objektet i en array eller lista.
Syntax
{%= head(array) %}
Exempel
Följande åtgärd returnerar den första av de fem främsta beställningarna med det högsta priset. Mer information om funktionen topN finns i avsnittet first n i array.
{%= head(topN(orders,price, 5)) %}
Sortera och hämta första N i en array first-n
Funktionen topN sorterar en array i fallande ordning baserat på det angivna numeriska uttrycket och returnerar de första N objekten. Om arraystorleken är mindre än N returneras hela den sorterade arrayen.
Den här funktionen
Syntax
{%= topN(array, value, amount) %}
{ARRAY}{VALUE}{AMOUNT}Exempel
Följande åtgärd returnerar de första fem beställningarna med det lägsta priset.
{%= topN(orders,price, 5) %}
I in
Funktionen in används för att avgöra om ett objekt är medlem i en array eller lista.
Syntax
{%= in(value, array) %}
Exempel
Följande åtgärd definierar personer med födelsedagar i mars, juni eller september.
{%= in (person.birthMonth, [3, 6, 9]) %}
Inkluderar includes
Funktionen includes används för att avgöra om en array eller lista innehåller ett visst objekt.
Syntax
{%= includes(array,item) %}
Exempel
Följande åtgärd definierar personer vars favoritfärg innehåller rött.
{%= includes(person.favoriteColors,"red") %}
Överlappningar intersects
Funktionen intersects används för att avgöra om två arrayer eller listor har minst en gemensam medlem.
Syntax
{%= intersects(array1, array2) %}
Exempel
Följande åtgärd definierar personer vars favoritfärger innehåller minst en röd, blå eller grön färg.
{%= intersects(person.favoriteColors,["red", "blue", "green"]) %}
Sortera och hämta sista N i en array last-n
Funktionen bottomN sorterar en array i stigande ordning baserat på det angivna numeriska uttrycket och returnerar de första N objekten. Om arraystorleken är mindre än N returneras hela den sorterade arrayen.
Syntax
{%= bottomN(array, value, amount) %}
{ARRAY}{VALUE}{AMOUNT}Exempel
Följande åtgärd returnerar de fem sista beställningarna med det högsta priset.
{%= bottomN(orders,price, 5) %}
Inte i notin
Funktionen notIn används för att avgöra om ett objekt inte är medlem i en array eller lista.
notIn-funktionen ser också till att inget av värdena är lika med null. Resultatet är därför inte en exakt negation av funktionen in.Syntax
{%= notIn(value, array) %}
Exempel
Följande åtgärd definierar personer med födelsedagar som inte är i mars, juni eller september.
{%= notIn(person.birthMonth ,[3, 6, 9]) %}
Delmängd av subset
Funktionen subsetOf används för att avgöra om en viss array (array A) är en delmängd av en annan array (array B). Det vill säga att alla element i array A är element i array B.
Syntax
{%= subsetOf(array1, array2) %}
Exempel
Följande åtgärd definierar personer som har besökt alla sina favoritstäder.
{%= subsetOf(person.favoriteCities,person.visitedCities) %}
Supermängd till superset
Funktionen supersetOf används för att avgöra om en viss array (array A) är en överordnad mängd till en annan array (array B). Arrayen A innehåller alltså alla element i array B.
Syntax
{%= supersetOf(array1, array2) %}
Exempel
Följande åtgärd definierar personer som har ätit sushi och pizza minst en gång.
{%= supersetOf(person.eatenFoods,["sushi", "pizza"]) %}