Funzioni array

Ultimo aggiornamento: 21 aprile 2025
  • Argomenti:

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.

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