Funções de matriz
join (array; separator)
Concatena todos os itens de uma matriz em uma cadeia de caracteres, usando o separador especificado entre cada item.
length (array)
Retorna o número de itens em uma matriz.
keys (object)
Retorna uma matriz das propriedades de um determinado objeto ou matriz.
slice (array; start; [end])
Retorna uma nova matriz contendo apenas itens selecionados.
merge (array1; array2; …)
Mescla uma ou mais matrizes em uma matriz.
contains (array; value)
Verifica se uma matriz contém o valor.
remove (array; value1; value2; …)
Remove valores especificados nos parâmetros de uma matriz. Esta função só é eficaz em matrizes primitivas de texto ou números.
add (array; value1; value2; …)
Adiciona valores especificados em parâmetros a uma matriz e retorna essa matriz.
map (complex array; key;[key for filtering];[possible values for filtering])
Retorna uma matriz primitiva contendo valores de uma matriz complexa. Esta função permite filtrar valores. Use nomes de variáveis brutos para chaves.
Exemplos:
-
map(Emails[];email)
Retorna uma matriz primitiva com emails
-
map(Emails[];email;label;work;home)
Retorna uma matriz primitiva com emails com rótulo igual a trabalho ou casa
Para obter mais informações, consulte Mapear uma matriz ou elemento de matriz.
ordem aleatória
sort (array; [order]; [key])
Classifica os valores de uma matriz. Os valores válidos do parâmetro order
são:
-
asc
(padrão) - ordem crescente: 1, 2, 3, … para o tipo Número. A, B, C, a, b, c, … para texto
-
desc
ordem decrescente: …, 3, 2, 1 para o tipo Number. …, c, b, a, C, B, A para texto.
-
asc ci
ordem crescente que não diferencia maiúsculas de minúsculas: A, a, B, b, C, c, … para o tipo Text.
-
desc ci
ordem decrescente que não diferencia maiúsculas de minúsculas: …, C, c, B, b, A, a para tipo de Texto.
Use o parâmetro key
para acessar propriedades dentro de objetos complexos.
Use nomes de variáveis brutos para chaves.
Para acessar propriedades aninhadas, use a notação de pontos.
O primeiro item em uma matriz é o índice 1.
Exemplos:
-
sort(Contacts[];name)
Classifica uma matriz de contatos pela propriedade "name" em ordem crescente padrão
-
sort(Contacts[];desc;name)
Classifica uma matriz de contatos pela propriedade "name" em ordem descendente
-
sort(Contacts[];asc ci;name)
Classifica uma matriz de contatos pela propriedade "name" em ordem crescente que não diferencia maiúsculas de minúsculas
-
sort(Emails[];sender.name)
Classifica uma matriz de emails pela propriedade "sender.name"
reverse (array)
O primeiro elemento da matriz se torna o último elemento, o segundo se torna o próximo ao último e assim por diante.
flatten (array)
Cria uma nova matriz com todos os elementos de submatriz concatenados nela, recursivamente, até a profundidade especificada.
distinct (array; [key])
Remove duplicatas dentro de uma matriz. Use o argumento "key" para acessar propriedades dentro de objetos complexos. Para acessar propriedades aninhadas, use a notação de pontos. O primeiro item em uma matriz é o índice 1.
Exemplo: distinct(Contacts[];name)
Remove duplicatas dentro de uma matriz de contatos comparando a propriedade "name"
toCollection
toArray
Esta função converte uma coleção em uma matriz de pares de valores chave.
Exemplos:
Dada a coleção
{ key1: "value1", key2: "value2:}
A função
toArray({ key1: "value1", key2: "value2:})
Retorna a matriz de pares de valores chave
[{ key1: "value1"}, { key2: "value2"}]
arrayDifference [array1, array2, mode]
Retorna a diferença entre duas matrizes.
Insira um dos seguintes valores para o parâmetro mode
.
-
classic
: retorna uma nova matriz que contém todos os elementos dearray1
que não existem emarray2
. -
symmetric
: retorna uma matriz de elementos que não são comuns a ambas as matrizes.Em outras palavras, a função retorna uma matriz que contém todos os elementos de
array1
que não existem emarray2
e todos os elementos dearray2
que não existem emarray1
.
Exemplos:
Considerando as seguintes matrizes:
myArray = [1,2,3,4,5]
yourArray = [3,4,5,6,7]
-
arrayDifference [myArray, yourArray, classic]
Retorna
[1,2]
-
arrayDifference [yourArray, myArray, classic]
Retorna
[6,7]
-
arrayDifference [myArray, yourArray, symmetric]
Retorna
[1,2,6,7]