Nesse artigo você encontrará as seguintes informações:
add (array; value1; value2; ...)
contains (array; value)
deduplicate (array)
distinct (array; [key])
first (array)
flatten (array)
join (array; separator)
keys (object)
last (array)
length (array)
map (complex array; key;[key for filtering];[possible values for filtering separated by a comma])
merge (array1; array2; ...)
remove (array; value1; value2; ...)
reverse (array)
shuffle (array)
slice (array; start; [end])
sort (array; [order]; [key])
toArray (collection)
toCollection (array; key; value)
add (array; value1; value2; ...)
Adiciona valores especificados em parâmetros a uma matriz e retorna essa matriz.
contains (array; value)
Verifica se uma matriz contém o valor.
deduplicate (array)
Remove duplicatas de uma matriz.
distinct (array; [key])
Remove duplicatas dentro de uma matriz. Use o argumento “key” para acessar propriedades dentro de objetos complexos. Para acessar propriedades hospedadas, use a notação de ponto. O primeiro item em uma array (matriz) é o índice 1.
distinct( Contacts[] ;name)
= Remove duplicatas dentro de uma matriz de contatos comparando a propriedade name .
first (array)
Retorna o primeiro elemento de um array.
flatten (array)
Cria uma nova matriz com todos os elementos da submatriz relacionados nela, repetidamente até a profundidade especificada.
Mais detalhes sobre a função flatten podem ser encontrados na documentação do Array.prototype.flat .
join (array; separator)
Relaciona todos os itens de uma matriz em uma string, usando um separador especificado entre cada item.
keys (object)
Retorna uma matriz das propriedades de um determinado objeto ou matriz.
last (array)
Retorna o último elemento de um array.
length (array)
Retorna o número de itens em uma matriz.
map (complex array; key;[key for filtering];[possible values for filtering separated by a comma])
Retorna um array primitivo contendo valores de um array complexo. Permite filtrar valores. Use nomes de variáveis brutas para chaves.
map( Emails[] ;e-mail)
= Retorna um array primitivo com emails.
map( Emails[] ;;rótulo de e-mail ;trabalho, casa)
= Retorna um array primitivo com e-mails que possuem um rótulo igual a trabalho ou casa.
merge (array1; array2; ...)
Mescla dois ou mais arrays em um array.
remove (array; value1; value2; ...)
Remove os valores especificados nos parâmetros de uma matriz. Eficaz apenas no caso de matrizes primitivas de texto ou números.
reverse (array)
O primeiro elemento da matriz torna-se o último elemento e vice-versa.
shuffle (array)
Embaralha (reordena aleatoriamente) os elementos de uma matriz.
slice (array; start; [end])
Retorna uma nova matriz contendo apenas itens selecionados. O primeiro item na matriz tem um índice de 0.
sort (array; [order]; [key])
Classifica os valores de uma matriz. Os valores válidos do parâmetro “order” são:
asc (default): ordem crescente: 1, 2, 3, ... para o tipo Número. A, B, C, a, b, c, ... para o tipo Texto.
desc : ordem decrescente: ..., 3, 2, 1 para o tipo Número. ..., c, b, a, C, B, A para o tipo Texto.
asc ci - ordem crescente sem distinção entre maiúsculas e minúsculas: A, a, B, b, C, c, ... para o tipo Texto.
desc ci - ordem decrescente que não diferencia maiúsculas de minúsculas: ..., C, c, B, b, A, a para o tipo Texto.
Use o parâmetro “key” para acessar propriedades dentro de objetos complexos. Use nomes de variáveis brutas para chaves. Para acessar propriedades aninhadas, use a notação de ponto. O primeiro item em uma matriz é o índice 1.
Exemplo 1. sort( Contacts[] ; name )
Classifica uma matriz de contatos pela propriedade “name” em ordem crescente padrão.
Exemplo 2. sort( Contacts[] ; desc ; name )
Classifica uma matriz de contatos pela propriedade” name” em ordem decrescente.
Exemplo 3. 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.
Exemplo 4. sort( Emails[] ; sender.name )
Classifica uma matriz de e-mails pela propriedade “sender.name”.
toArray (collection)
Converte uma coleção em uma matriz de coleções de key-value (chave-valor).
toCollection (array; key; value)
Converte uma matriz contendo objetos com pares key-value (chave-valor) em uma coleção.
Pronto! Agora você já sabe tudo sobre a função “Array” no Toolzz Connect.