Funções de matriz

Última atualização: 21 de abril de 2025
  • Tópicos:

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