List.Skip

La función List.Skip devuelve una lista tras omitir ciertos elementos del comienzo.

Sintaxis

List.Skip(
    list as list,
    optional countOrCondition as any
) as list

Parámetros
  • list: lista de la que omitir los primeros elementos
  • countOrCondition: (opcional) condición que determina los elementos a omitir
Información adicional

La función List.Skip tiene el siguiente comportamiento:

  • Si no se incluye el argumento countOrCondition, se omite el primer elemento y se devuelve el resto.
  • Si la lista está vacía, se devuelve una lista vacía con independencia del valor que tome el parámetro countOrCondition.
  • Si el argumento countOrCondition es un número, se omitirá dicho número de elementos del comienzo de la lista y se devolverá el resto. Si el número de elementos a omitir es mayor que el número de elementos disponibles, se devuelve una lista vacía.
  • Si el argumento countOrCondition es una condición, la función omitirá los elementos que, situados al comienzo de la lista, satisfagan la condición, y devolverá los elementos situados a partir del primero que no la satisfaga. Si ningún elemento del comienzo de la lista satisface la condición, se devuelve la lista completa.
  • Si el argumento countOrCondition toma el valor null, la función omitirá el primer elemento y devolverá el resto.
Ejemplos

Si pasamos a esta función la lista de números entre el 1 y el 6 y no especificamos el parámetro countOrCondition, la función devuelve todos los números menos el primero:

let
    numbers = {1..6}
in
    List.Skip(
        numbers
    )

Función M List.Skip

Si se especifica el parámetro countOrCondition y éste es un número, se omite dicho número de elementos del comienzo de la lista:

let
    numbers = {1..6}
in
    List.Skip(
        numbers,
        3
    )

Función M List.Skip

Si el número de elementos a omitir es mayor que el número de elementos disponibles, se devuelve una lista vacía:

let
    numbers = {1..6}
in
    List.Skip(
        numbers,
        19
    )

Función M List.Skip

En este ejemplo partimos de una lista de números positivos y negativos, y deseamos eliminar aquellos que, situados al comienzo de la lista, sean menores que cero:

let
    numbers = {-2,-1,3,1,-1,4}
in
    List.Skip(
        numbers,
        each _ < 0
    )

Función M List.Skip

Siguiendo con el mismo ejemplo, si ningún elemento del comienzo de la lista satisface la condición, se devuelve la lista completa:

let
    numbers = {5,-2,-1,3,1,-1,4}
in
    List.Skip(
        numbers,
        each _ < 0
    )

Función M List.Skip
Categoría
Funciones de lista
Enviado por admin el Mar, 11/08/2020 - 18:07