Funzioni array

join (matrice; separatore)

Concatena tutti gli elementi di un array in una stringa utilizzando il separatore specificato tra ogni elemento.

lunghezza (array)

Restituisce il numero di elementi in una matrice.

chiavi (oggetto)

Restituisce una matrice delle proprietà di un determinato oggetto o matrice.

sezione (matrice; inizio; [fine])

Restituisce una nuova matrice contenente solo gli elementi selezionati.

unisci (matrice1; matrice2; …)

Unisce uno o più array in un unico array.

contiene (matrice; valore)

Verifica se un array contiene il valore.

rimuovere (matrice; valore1; valore2; …)

Rimuove i valori specificati nei parametri di un array. Questa funzione è efficace solo su array primitivi di testo o numeri.

aggiungi (matrice; valore1; valore2; …)

Aggiunge i valori specificati nei parametri a un array e restituisce tale array.

mappa (matrice complessa; chiave;[chiave per filtrare];[valori possibili per filtrare])

Restituisce una matrice primitiva contenente i valori di una matrice complessa. Questa funzione consente di filtrare i valori. Utilizza nomi di variabili non elaborati per le chiavi.

recommendation-more-help

Esempi:

  • map(Emails[];email)

    Restituisce un array primitivo con le e-mail

  • map(Emails[];email;label;work;home)

    Restituisce un array primitivo con e-mail aventi un’etichetta uguale a lavoro o casa

Per ulteriori informazioni, vedere Mappare un array o un elemento di array.

mischiare

ordinamento (matrice; [ordine]; [chiave])

Ordina i valori di un array. I valori validi del parametro order sono:

  • asc

    (impostazione predefinita) - Ordine crescente: 1, 2, 3, … per il tipo Numero. A, B, C, a, b, c, … per il tipo Testo

  • desc

    ordine decrescente: …, 3, 2, 1 per il tipo Numero. …, c, b, a, C, B, A per il tipo Testo.

  • asc ci

    ordine crescente senza distinzione tra maiuscole e minuscole: A, a, B, b, C, c, … per il tipo Testo.

  • desc ci

    ordine decrescente senza distinzione tra maiuscole e minuscole: …, C, c, B, b, A, a per il tipo Testo.

Utilizzare il parametro key per accedere alle proprietà di oggetti complessi.

Utilizza nomi di variabili non elaborati per le chiavi.

Per accedere alle proprietà nidificate, utilizza la notazione del punto.

Il primo elemento di un array è l'indice 1.

Esempi:

  • sort(Contacts[];name)

    Ordina un array di contatti in base alla proprietà "name" in ordine crescente predefinito

  • sort(Contacts[];desc;name)

    Ordina un array di contatti in base alla proprietà "name" in ordine decrescente

  • sort(Contacts[];asc ci;name)

    Ordina un array di contatti in base alla proprietà "name", in ordine crescente senza distinzione tra maiuscole e minuscole

  • sort(Emails[];sender.name)

    Ordina un array di e-mail in base alla proprietà "sender.name"

inverso (matrice)

Il primo elemento dell’array diventa l’ultimo elemento, il secondo diventa il successivo-ultimo e così via.

appiattire (matrice)

Crea un nuovo array con tutti gli elementi sub-array concatenati in esso, in modo ricorsivo, fino alla profondità specificata.

distinct (array; [key])

Rimuove i duplicati all'interno di un array. Utilizza l'argomento "key" per accedere alle proprietà all'interno di oggetti complessi. Per accedere alle proprietà nidificate, utilizza la notazione del punto. Il primo elemento di un array è l'indice 1.

Esempio: distinct(Contacts[];name)

Rimuove i duplicati in un array di contatti confrontando la proprietà "name"

toCollection

  • Questa funzione accetta un array contenente coppie chiave-valore e lo converte in una raccolta. La funzione dispone di 3 argomenti:

  • (array) contenente coppie di valori chiave

  • (stringa) nome del campo da utilizzare come chiave

  • (stringa) nome del campo da utilizzare come valore

Esempio:

Dato un array:

[{"name":"Bob", "age":22}, {"name":"Tim", "age":23}]

argomenti e

{{toCollection(6.array; "name"; "age")}}

la funzione restituisce

{
    "Bob": 22,
    "Tim": 23
}

toArray

Questa funzione converte una raccolta in un array di coppie chiave-valore.

Esempi:

Data la raccolta

{ key1: "value1", key2: "value2:}

La funzione

toArray({ key1: "value1", key2: "value2:})

Restituisce la matrice di coppie chiave-valore

[{ key1: "value1"}, { key2: "value2"}]

arrayDifference [array1, array2, modalità]

Restituisce la differenza tra due array.

Immettere uno dei seguenti valori per il parametro mode.

  • classic: restituisce un nuovo array che contiene tutti gli elementi di array1 che non esistono in array2.

  • symmetric: restituisce una matrice di elementi non comuni a entrambe le matrici.

    In altre parole, la funzione restituisce un array che contiene tutti gli elementi di array1 che non esistono in array2 e tutti gli elementi di array2 che non esistono in array1.

Esempi:

Considerati i seguenti array:

myArray = [1,2,3,4,5]
yourArray = [3,4,5,6,7]
  • arrayDifference [myArray, yourArray, classic]

    Restituisce [1,2]

  • arrayDifference [yourArray, myArray, classic]

    Restituisce [6,7]

  • arrayDifference [myArray, yourArray, symmetric]

    Restituisce [1,2,6,7]

deDuplica

Parole chiave

emptyarray

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