Funciones de matriz

Última actualización: 21 de abril de 2025
  • Temas:

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 solo 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

  • Esta función toma una matriz que contiene pares de clave-valor y la convierte en una colección. La función tiene tres argumentos:

  • (matriz) que contiene pares de valor clave

  • (cadena) el nombre del campo que se utilizará como clave

  • (cadena) el nombre del campo que se utilizará como valor