Fonctions de tableau
join (array; separator)
Concatène tous les éléments d’un tableau en une chaîne, en utilisant le séparateur spécifié entre chaque élément.
length (array)
Renvoie le nombre d’éléments d’un tableau.
keys (object)
Renvoie un tableau des propriétés d’un objet ou d’un tableau donné.
slice (array; start; [end])
Renvoie un nouveau tableau contenant uniquement les éléments sélectionnés.
merge (array1; array2; …)
Fusionne un ou plusieurs tableaux en un seul.
contains (array; value)
Vérifie si un tableau contient la valeur.
remove (array; value1; value2; …)
Supprime les valeurs spécifiées dans les paramètres d’un tableau. Cette fonction est efficace uniquement pour les tableaux primitifs de textes ou de nombres.
add (array; value1; value2; …)
Ajoute les valeurs spécifiées dans les paramètres à un tableau et renvoie ce tableau.
map (complex array; key;[key for filtering];[valeurs possibles pour le filtrage])
Renvoie un tableau primitif contenant les valeurs d’un tableau complexe. Cette fonction permet de filtrer les valeurs. Utilisez des noms de variables bruts pour les clés.
Exemples :
-
map(Emails[];email)Renvoie un tableau primitif contenant les e-mails.
-
map(Emails[];email;label;work)Renvoie un tableau primitif avec les e-mails dont le libellé est égal à work
Pour plus d’informations, voir Mapper un tableau ou un élément de tableau.
shuffle
sort (array; [order]; [key])
Trie les valeurs d’un tableau. Les valeurs valides du paramètre order sont les suivantes :
-
asc(par défaut) - ordre croissant : 1, 2, 3, … pour le type Nombre. A, B, C, a, b, c, … pour le type Texte.
-
descordre décroissant : …, 3, 2, 1 pour le type Nombre. …, c, b, a, C, B, A pour le type Texte.
-
asc ciordre croissant insensible à la casse : A, a, B, b, C, c, … pour le type Texte.
-
desc ciordre décroissant insensible à la casse : …, C, c, B, b, A, a pour le type Texte.
Utilisez le paramètre key pour accéder aux propriétés des objets complexes.
Utilisez des noms de variables bruts pour les clés.
Pour accéder aux propriétés imbriquées, utilisez la notation avec point.
Le premier élément d’un tableau est l’index 1.
Exemples :
-
sort(Contacts[];name)Trie un tableau de contacts en fonction de la propriété « name » dans l’ordre croissant par défaut.
-
sort(Contacts[];desc;name)Trie un tableau de contacts en fonction de la propriété « name » dans l’ordre décroissant.
-
sort(Contacts[];asc ci;name)Trie un tableau de contacts en fonction de la propriété « name » dans l’ordre croissant insensible à la casse.
-
sort(Emails[];sender.name)Trie un tableau d’e-mails en fonction de la propriété « sender.name ».
reverse (array)
Le premier élément du tableau devient le dernier élément, le deuxième devient l’avant-dernier, et ainsi de suite.
flatten (array)
Crée un nouveau tableau dans lequel sont concaténés tous les éléments des sous-tableaux, de manière récursive, jusqu’à la profondeur spécifiée.
distinct (array; [key])
Supprime les doublons dans un tableau. Utilisez l’argument « key » pour accéder aux propriétés des objets complexes. Pour accéder aux propriétés imbriquées, utilisez la notation avec point. Le premier élément d’un tableau est l’index 1.
Exemple : distinct(Contacts[];name)
Supprime les doublons dans un tableau de contacts en comparant la propriété « nom ».
toCollection
-
Cette fonction prend un tableau contenant des paires clé-valeur et le convertit en une collection. La fonction comporte 3 arguments :
-
(tableau) contenant des paires clé-valeur
-
(chaîne) nom du champ à utiliser comme clé
-
(chaîne) nom du champ à utiliser comme valeur
Exemple :
Dans un tableau :
[{"name":"Bob", "age":22}, {"name":"Tim", "age":23}]
et arguments
{{toCollection(6.array; "name"; "age")}}
la fonction renvoie .
{
"Bob": 22,
"Tim": 23
}
toArray
Cette fonction convertit une collection en un tableau de paires clé-valeur.
Exemples :
Prenons l’exemple de la collection suivante :
{ key1: "value1", key2: "value2:}
La fonction
toArray({ key1: "value1", key2: "value2:})
Renvoie le tableau de paires clé-valeur
[{ key1: "value1"}, { key2: "value2"}]
arrayDifference [array1, array2, mode]
Renvoie la différence entre deux tableaux.
Saisissez l’une des valeurs suivantes pour le paramètre mode.
-
classic: renvoie un nouveau tableau contenant tous les éléments dearray1qui n’existent pas dansarray2. -
symmetric: renvoie un tableau d’éléments qui ne sont pas communs aux deux tableaux.En d’autres termes, la fonction renvoie un tableau contenant tous les éléments de
array1qui n’existent pas dansarray2, et tous les éléments dearray2qui n’existent pas dansarray1.
Exemples :
Les tableaux suivants :
myArray = [1,2,3,4,5]
yourArray = [3,4,5,6,7]
-
arrayDifference [myArray, yourArray, classic]Retourne
[1,2] -
arrayDifference [yourArray, myArray, classic]Renvoie
[6,7] -
arrayDifference [myArray, yourArray, symmetric]Renvoie
[1,2,6,7]