Arrayfuncties

Laatst bijgewerkt: 21 april 2025
  • Onderwerpen:

join (array; separator)

Hiermee worden alle items van een array samengevoegd in een tekenreeks, waarbij het opgegeven scheidingsteken tussen elk item wordt gebruikt.

length (array)

Retourneert het aantal items in een array.

keys (object)

Retourneert een array van de eigenschappen van een bepaald object of een bepaalde array.

slice (array; start; [end])

Retourneert een nieuwe array die alleen geselecteerde items bevat.

merge (array1; array2; …)

Voegt een of meer arrays samen tot één array.

contains (array; value)

Controleert of een array de waarde bevat.

remove (array; value1; value2; …)

Verwijdert waarden die zijn opgegeven in de parameters van een array. Deze functie is alleen effectief op primitieve arrays met tekst of getallen.

add (array; value1; value2; …)

Voegt waarden die in parameters zijn opgegeven toe aan een array en retourneert die array.

map (complex array; key;[key for filtering];[possible values for filtering])

Retourneert een primitieve array met waarden van een complexe array. Deze functie staat het filtreren waarden toe. Gebruik namen van onbewerkte variabelen voor sleutels.

Voorbeelden:

  • map(Emails[];email)

    Retourneert een primitieve array met e-mails

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

    Retourneert een primitieve array met e-mails met een label dat gelijk is aan werk of privé

Voor meer informatie, zie een serie of serieelementin kaart brengen.

schudden

sort (array; [order]; [key])

Sorteert waarden van een array. De geldige waarden voor de parameter order zijn:

  • asc

    (standaardwaarde) - oplopende volgorde: 1, 2, 3, … voor het type Number. A, B, C, a, b, c… voor tekst

  • desc

    Aflopende volgorde: …, 3, 2, 1 voor type Number. …, c, b, a, C, B, A voor tekst.

  • asc ci

    niet-hoofdlettergevoelige oplopende volgorde: A, a, B, b, C, c, … voor tekst.

  • desc ci

    niet-hoofdlettergevoelige aflopende volgorde: …, C, c, B, b, A, a voor tekst.

Gebruik de parameter key om eigenschappen binnen complexe objecten te benaderen.

Gebruik namen van onbewerkte variabelen voor sleutels.

Gebruik puntnotatie voor toegang tot geneste eigenschappen.

Het eerste item in een array is index 1.

Voorbeelden:

  • sort(Contacts[];name)

    Hiermee wordt een array van contactpersonen gesorteerd op de eigenschap "name" in oplopende volgorde

  • sort(Contacts[];desc;name)

    Hiermee wordt een array van contactpersonen gesorteerd op de eigenschap "name" in aflopende volgorde

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

    Hiermee wordt een array van contactpersonen gesorteerd op de eigenschap "name" in hoofdlettergevoelige oplopende volgorde

  • sort(Emails[];sender.name)

    Hiermee wordt een array met e-mailberichten gesorteerd op de eigenschap "sender.name"

reverse (array)

Het eerste element van de array wordt het laatste element, het tweede het op een na laatste element enzovoort.

flatten (array)

Hiermee wordt een nieuwe array gemaakt waarin alle elementen van de subarray recursief tot de opgegeven diepte zijn samengevoegd.

distinct (array; [key])

Hiermee worden duplicaten uit een array verwijderd. Gebruik het argument "key" om toegang te krijgen tot eigenschappen binnen complexe objecten. Gebruik puntnotatie voor toegang tot geneste eigenschappen. Het eerste item in een array is index 1.

Voorbeeld: distinct(Contacts[];name)

Verwijdert duplicaten binnen een array van contactpersonen door de eigenschap "name" te vergelijken

toCollection

  • Deze functie neemt een serie die zeer belangrijk-waardeparen bevat en zet het in een inzameling om. De functie heeft drie argumenten:

  • (array) met sleutelwaardeparen

  • (tekenreeks) de naam van het veld dat als sleutel moet worden gebruikt

  • (tekenreeks) de naam van het veld dat als waarde moet worden gebruikt