Array-funktioner

join (array; separator)

Sammanfogar alla objekt i en array till en sträng med den angivna avgränsaren mellan varje objekt.

length (array)

Returnerar antalet objekt i en array.

keys (object)

Returnerar en array med egenskaperna för ett givet objekt eller en angiven array.

slice (array; start; [end])

Returnerar en ny array som endast innehåller markerade objekt.

merge (array1; array2; …)

Sammanfogar en eller flera arrayer till en array.

contains (array; value)

Verifierar om en array innehåller värdet.

remove (array; value1; value2; …)

Tar bort värden som anges i parametrarna för en array. Den här funktionen gäller bara för primitiva arrayer med text eller siffror.

add (array; value1; value2; …)

Lägger till värden som anges i parametrar till en array och returnerar den arrayen.

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

Returnerar en primitiv array som innehåller värden för en komplex array. Den här funktionen tillåter filtrering av värden. Använd råa variabelnamn för nycklar.

recommendation-more-help

Exempel:

  • map(Emails[];email)

    Returnerar en primitiv array med e-post

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

    Returnerar en primitiv matris med e-postmeddelanden som har en etikett som är lika med arbetet eller hemmet

Mer information finns i Mappa en array eller ett arrayelement.

blanda

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

Sorterar värden i en array. Giltiga värden för parametern order är:

  • asc

    (standard) - stigande ordning: 1, 2, 3, … för typen Number. A, B, C, a, b, c, … för text

  • desc

    fallande ordning: …, 3, 2, 1 för typen Number. …, c, b, a, C, B, A för typen Text.

  • asc ci

    skiftlägesokänslig stigande ordning: A, a, B, b, C, c, … för text.

  • desc ci

    skiftlägesokänslig fallande ordning: …, C, c, B, b, A, a för text.

Använd parametern key för att komma åt egenskaper i komplexa objekt.

Använd råa variabelnamn för nycklar.

Använd punktnotation om du vill komma åt kapslade egenskaper.

Det första objektet i en array är index 1.

Exempel:

  • sort(Contacts[];name)

    Sorterar en array med kontakter efter egenskapen "name" i standardstigande ordning

  • sort(Contacts[];desc;name)

    Sorterar en array med kontakter efter egenskapen "name" i fallande ordning

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

    Sorterar en array med kontakter efter egenskapen "name" i fallokänslig stigande ordning

  • sort(Emails[];sender.name)

    Sorterar en matris med e-postmeddelanden efter egenskapen "sender.name"

reverse (array)

Det första elementet i arrayen blir det sista elementet, det andra blir det näst sista och så vidare.

flatten (array)

Skapar en ny array med alla underarrayelement sammanfogade rekursivt, upp till det angivna djupet.

distinct (array; [key])

Tar bort dubbletter inuti en array. Använd argumentet key för att komma åt egenskaper i komplexa objekt. Använd punktnotation om du vill komma åt kapslade egenskaper. Det första objektet i en array är index 1.

Exempel: distinct(Contacts[];name)

Tar bort dubbletter i en array med kontakter genom att jämföra egenskapen name

toCollection

  • Den här funktionen tar en array som innehåller nyckelvärdepar och konverterar den till en samling. Funktionen har tre argument:

  • (array) som innehåller nyckelvärdepar

  • (sträng) namnet på fältet som ska användas som nyckel

  • (sträng) namnet på fältet som ska användas som värde

Exempel:

En matris:

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

och argument

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

funktionen returnerar

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

toArray

Den här funktionen konverterar en samling till en array med nyckelvärdepar.

Exempel:

Utgående från samlingen

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

Funktionen

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

Returnerar arrayen med nyckelvärdepar

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

arrayDifference [array1, array2, mode]

Returnerar skillnaden mellan två arrayer.

Ange ett av följande värden för parametern mode.

  • classic: Returnerar en ny array som innehåller alla element i array1 som inte finns i array2.

  • symmetric: Returnerar en array med element som inte är gemensamma för båda arrayerna.

    Funktionen returnerar med andra ord en array som innehåller alla element i array1 som inte finns i array2 och alla element i array2 som inte finns i array1.

Exempel:

Följande arrayer:

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

    Returnerar [1,2]

  • arrayDifference [yourArray, myArray, classic]

    Returnerar [6,7]

  • arrayDifference [myArray, yourArray, symmetric]

    Returnerar [1,2,6,7]

deDuplicate

Nyckelord

emptyarray

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