Matrizes e funções de lista
- Tópicos:
- Personalização
Criado para:
- Experiente
- Desenvolvedor
Use essas funções para facilitar a interação com matrizes, listas e sequências de caracteres.
Somente contagem nula
A função countOnlyNull
é usada para contar o número de valores nulos em uma lista.
Sintaxe
{%= countOnlyNull(array) %}
Exemplo
{%= countOnlyNull([4,0,1,6,0,0]) %}
Retorna 3.
Contagem com nulo
A função countWithNull
é usada para contar todos os elementos de uma lista, incluindo valores nulos.
Sintaxe
{%= countWithNull(array) %}
Exemplo
{%= countOnlyNull([4,0,1,6,0,0]) %}
Retorna 6.
Distinto
A função distinct
é usada para obter valores de uma matriz ou lista com valores duplicados removidos.
Sintaxe
{%= distinct(array) %}
Exemplo
A operação a seguir especifica as pessoas que fizeram pedidos em mais de um armazenamento.
{%= distinct(person.orders.storeId).count() > 1 %}
Contagem distinta com nulo
A função distinctCountWithNull
é usada para contar o número de valores diferentes em uma lista, incluindo os valores nulos.
Sintaxe
{%= distinctCountWithNull(array) %}
Exemplo
{%= distinctCountWithNull([10,2,10,null]) %}
Retorna 3.
Primeiro item
A função head
é usada para retornar o primeiro item em uma matriz ou lista.
Sintaxe
{%= head(array) %}
Exemplo
A operação a seguir retorna a primeira das cinco ordens principais com o preço mais alto. Mais informações sobre a função topN
podem ser encontradas na primeira n
da seção de matriz.
{%= head(topN(orders,price, 5)) %}
Primeiro n
na matriz
A função topN
é usada para retornar os primeiros N
itens em uma matriz, quando classificados em ordem crescente com base na expressão numérica fornecida.
Sintaxe
{%= topN(array, value, amount) %}
{ARRAY}
{VALUE}
{AMOUNT}
Exemplo
A operação a seguir retorna as cinco primeiras ordens com o preço mais baixo.
{%= topN(orders,price, 5) %}
Em
A função in
é usada para determinar se um item é membro de uma matriz ou lista.
Sintaxe
{%= in(value, array) %}
Exemplo
A operação a seguir define as pessoas com aniversários em março, junho ou setembro.
{%= in (person.birthMonth, [3, 6, 9]) %}
Inclui
A função includes
é usada para determinar se uma matriz ou lista contém um determinado item.
Sintaxe
{%= includes(array,item) %}
Exemplo
A operação a seguir define as pessoas cuja cor favorita inclui vermelho.
{%= includes(person.favoriteColors,"red") %}
Intersecta
A função intersects
é usada para determinar se duas matrizes ou listas têm pelo menos um membro comum.
Sintaxe
{%= intersects(array1, array2) %}
Exemplo
A operação a seguir define as pessoas cujas cores favoritas incluem pelo menos uma das cores vermelha, azul ou verde.
{%= intersects(person.favoriteColors,["red", "blue", "green"]) %}
Último n
na matriz
A função bottomN
é usada para retornar os últimos N
itens em uma matriz, quando classificados em ordem crescente com base na expressão numérica fornecida.
Sintaxe
{%= bottomN(array, value, amount) %}
{ARRAY}
{VALUE}
{AMOUNT}
Exemplo
A operação a seguir retorna as cinco últimas ordens com o preço mais alto.
{%= bottomN(orders,price, 5) %}
Não está em
A função notIn
é usada para determinar se um item não é membro de uma matriz ou lista.
notIn
também garante que nenhum dos valores seja igual a nulo. Portanto, os resultados não são uma negação exata da função in
.Sintaxe
{%= notIn(value, array) %}
Exemplo
A operação a seguir define as pessoas com aniversários que não são em março, junho ou setembro.
{%= notIn(person.birthMonth ,[3, 6, 9]) %}
Subconjunto de
A função subsetOf
é usada para determinar se uma matriz específica (matriz A) é um subconjunto de outra matriz (matriz B). Em outras palavras, que todos os elementos na matriz A são elementos da matriz B.
Sintaxe
{%= subsetOf(array1, array2) %}
Exemplo
A operação a seguir define as pessoas que visitaram todas as cidades favoritas.
{%= subsetOf(person.favoriteCities,person.visitedCities) %}
Superconjunto de
A função supersetOf
é usada para determinar se uma matriz específica (matriz A) é um superconjunto de outra matriz (matriz B). Em outras palavras, essa matriz A contém todos os elementos na matriz B.
Sintaxe
{%= supersetOf(array1, array2) %}
Exemplo
A operação seguinte define as pessoas que comeram sushi e pizza pelo menos uma vez.
{%= supersetOf(person.eatenFoods,["sushi", "pizza"] %}