List.Alternate

La función List.Alternate extrae valores de una lista según el patrón indicado.

Sintaxis

List.Alternate(
    list as list,
    count as number,
    optional repeatInterval as nullable number,
    optional offset as nullable number
) as list

Parámetros
  • list: lista de la que realizar la extracción
  • count: número de valores a saltar antes de incluir el siguiente bloque de valores
  • repeatInterval: (opcional) número de valores a incluir
  • offset: (opcional) número de valores del comienzo de la lista a incluir antes de empezar a saltar valores
Información adicional

Si no se indica el parámetro repeatInterval, se incluyen todos los elementos.

De forma semejante, si no se indica el valor offset, se le supone un valor de 0.

Ejemplos

Partimos de la lista formada por los números entre el 1 y el 20. Con la siguiente expresión estamos saltando un valor (el 1) e incluyendo todos los demás:

List.Alternate(
    {1..20},
    1
)

List

Función M List.Alternate

Un clic en el enlace List anterior nos muestra la lista generada:

Función M List.Alternate

Vemos que, efectivamente, se ha saltado el primer valor y se han incluido los demás.

Si, en el ejemplo anterior, especificamos el número de elementos a incluir (por ejemplo, 2), el resultado es el siguiente:

List.Alternate(
    {1..20},
    1,
    2
)

Función M List.Alternate

Comprobamos que se ha saltado un elemento (el 1), se han añadido dos (2 y 3), se ha saltado otro (el 4), se han añadido dos... y así sucesivamente.

Por último, si añadimos el cuarto parámetro, offset, el proceso anterior comenzará tras incluir el número indicado de valores del comienzo de la lista. Por ejemplo:

List.Alternate(
    {1..20},
    1,
    2,
    4
)

Función M List.Alternate

Vemos que se han añadido a la lista final los cuatro primeros elementos (del 1 al 4), se ha saltado uno (el 5), se han añadido dos (6 y 7), se ha saltado otro (el 8), etc.

Categoría
Funciones de lista
Submitted by admin on Thu, 07/23/2020 - 10:57