La función List.Skip devuelve una lista tras omitir ciertos elementos del comienzo.
List.Skip(
list as list,
optional countOrCondition as any
) as list
- list: lista de la que omitir los primeros elementos
- countOrCondition: (opcional) condición que determina los elementos a omitir
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.
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
)
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
)
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
)
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
)
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
)
