Funciones de matriz
join (array; separator)
Concatena todos los elementos de una matriz en una cadena, utilizando el separador especificado entre cada elemento.
length (array)
Devuelve el número de elementos de una matriz.
keys (object)
Devuelve una matriz de las propiedades de un objeto o matriz determinados.
slice (array; start; [end])
Devuelve una nueva matriz que contiene solo los elementos seleccionados.
merge (array1; array2; …)
Combina una o más matrices en una matriz.
contains (array; value)
Comprueba si una matriz contiene el valor.
remove (array; value1; value2; …)
Quita los valores especificados en los parámetros de una matriz. Esta función sólo es efectiva en matrices primitivas de texto o números.
add (array; value1; value2; …)
Añade los valores especificados en parámetros a una matriz y devuelve esa matriz.
map (complex array; key;[key for filtering];[possible values for filtering])
Devuelve una matriz primitiva que contiene los valores de una matriz compleja. Esta función permite filtrar valores. Utilice nombres de variables sin procesar para las claves.
Ejemplos:
-
map(Emails[];email)
Devuelve una matriz primitiva con correos electrónicos
-
map(Emails[];email;label;work;home)
Devuelve una matriz primitiva con correos electrónicos que tienen una etiqueta igual a trabajo o inicio
Para obtener más información, vea Asignar una matriz o elemento de matriz.
shuffle
sort (array; [order]; [key])
Ordena los valores de una matriz. Los valores válidos del parámetro order
son los siguientes:
-
asc
(predeterminado): orden ascendente: 1, 2, 3, … para el tipo Número. A, B, C, a, b, c, … para el tipo Texto
-
desc
orden descendente: …, 3, 2, 1 para el tipo Número. …, c, b, a, C, B, A para el tipo Texto.
-
asc ci
orden ascendente sin distinción de mayúsculas y minúsculas: A, a, B, b, C, c, … para el tipo Texto.
-
desc ci
orden descendente sin distinción de mayúsculas y minúsculas: …, C, c, B, b, A, a para el tipo Texto.
Utilice el parámetro key
para tener acceso a las propiedades de objetos complejos.
Utilice nombres de variables sin procesar para las claves.
Para acceder a las propiedades anidadas, utilice la notación de puntos.
El primer elemento de una matriz es el índice 1.
Ejemplos:
-
sort(Contacts[];name)
Ordena una matriz de contactos por la propiedad "name" en orden ascendente predeterminado
-
sort(Contacts[];desc;name)
Ordena una matriz de contactos por la propiedad "name" en orden descendente
-
sort(Contacts[];asc ci;name)
Ordena una matriz de contactos por la propiedad “name” en orden ascendente sin distinción de mayúsculas y minúsculas
-
sort(Emails[];sender.name)
Ordena una matriz de correos electrónicos por la propiedad “sender.name”
reverse (array)
El primer elemento de la matriz se convierte en el último elemento, el segundo en el último, etc.
flatten (array)
Crea una nueva matriz con todos los elementos de submatriz concatenados en ella, de forma recursiva, hasta la profundidad especificada.
distinct (array; [key])
Elimina los duplicados dentro de una matriz. Utilice el argumento "key" para tener acceso a las propiedades de objetos complejos. Para acceder a las propiedades anidadas, utilice la notación de puntos. El primer elemento de una matriz es el índice 1.
Ejemplo:distinct(Contacts[];name)
Elimina los duplicados dentro de una matriz de contactos comparando la propiedad “name”
toCollection
toArray
Esta función convierte una colección en una matriz de pares clave-valor.
Ejemplos:
Dada la colección
{ key1: "value1", key2: "value2:}
La función
toArray({ key1: "value1", key2: "value2:})
Devuelve la matriz de pares clave-valor
[{ key1: "value1"}, { key2: "value2"}]
arrayDifference [array1, array2, mode]
Devuelve la diferencia entre dos matrices.
Introduzca uno de los siguientes valores para el parámetro mode
.
-
classic
: devuelve una nueva matriz que contiene todos los elementos dearray1
que no existen enarray2
. -
symmetric
: devuelve una matriz de elementos que no son comunes a ambas matrices.En otras palabras, la función devuelve una matriz que contiene todos los elementos de
array1
que no existen enarray2
y todos los elementos dearray2
que no existen enarray1
.
Ejemplos:
Dadas las siguientes matrices:
myArray = [1,2,3,4,5]
yourArray = [3,4,5,6,7]
-
arrayDifference [myArray, yourArray, classic]
Devuelve
[1,2]
-
arrayDifference [yourArray, myArray, classic]
Devuelve
[6,7]
-
arrayDifference [myArray, yourArray, symmetric]
Devuelve
[1,2,6,7]