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.
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 iarray1
som inte finns iarray2
. -
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 iarray2
och alla element iarray2
som inte finns iarray1
.
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]