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.

recommendation-more-help

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 de array1 que não existem em array2.

  • 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 em array2 e todos os elementos de array2 que não existem em array1.

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]

desduplicar

Palavras-chave

emptyarray

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3