Funções de matriz
junção (matriz; separador)
Concatena todos os itens de uma matriz em uma cadeia de caracteres, usando o separador especificado entre cada item.
comprimento (matriz)
Retorna o número de itens em uma matriz.
chaves (objeto)
Retorna uma matriz das propriedades de um determinado objeto ou matriz.
fatia (matriz; início; [fim])
Retorna uma nova matriz contendo apenas itens selecionados.
mesclar (matriz1; matriz2; …)
Mescla uma ou mais matrizes em uma matriz.
contém (matriz; valor)
Verifica se uma matriz contém o valor.
remover (matriz; valor1; valor2; …)
Remove valores especificados nos parâmetros de uma matriz. Esta função só é eficaz em matrizes primitivas de texto ou números.
adicionar (matriz; valor1; valor2; …)
Adiciona valores especificados em parâmetros a uma matriz e retorna essa matriz.
mapa (matriz complexa; chave;[chave para filtragem];[valores possíveis para filtragem])
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
classificar (matriz; [ordem]; [chave])
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"
inverter (matriz)
O primeiro elemento da matriz se torna o último elemento, o segundo se torna o próximo ao último e assim por diante.
nivelar (matriz)
Cria uma nova matriz com todos os elementos de submatriz concatenados nela, recursivamente, até a profundidade especificada.
distinct (matriz; [chave])
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
-
Esta função pega uma matriz que contém pares de valores chave e a converte em uma coleção. Há 3 argumentos para a função:
-
(matriz) contendo pares de valores chave
-
(string) o nome do campo a ser usado como chave
-
(string) o nome do campo a ser usado como valor
Exemplo:
Dada uma matriz:
[{"name":"Bob", "age":22}, {"name":"Tim", "age":23}]
e argumentos
{{toCollection(6.array; "name"; "age")}}
a função retorna
{
"Bob": 22,
"Tim": 23
}
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, modo]
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]