La función List.RemoveFirstN devuelve una lista tras eliminar los primeros N elementos o los primeros elementos que satisfagan una cierta condición.
List.RemoveFirstN(
list as list,
optional countOrCondition as any
) as list
- list: lista de la que eliminar los primeros elementos
- countOrCondition: número de elementos a eliminar o condición que deberán satisfacer para ser eliminados
Si el argumento countOrCondition es un valor numérico, se eliminará dicho número de elementos del comienzo de la lista. Si se eliminan más elementos de los que hay, se devuelve una lista vacía.
Si se trata de una condición, la función eliminará los elementos del comienzo de la lista que la satisfagan hasta que encuentre el primero que no lo haga.
Si se especifica 0 como número de elementos a eliminar, o si ningún elemento satisface la condición indicada, la función devuelve la lista original.
Si no se especifica el argumento countOrCondition, se elimina el primer elemento de la lista.
Podemos eliminar los dos primeros elementos de la lista {2, 4, 6, 3, 5} con la siguiente expresión:
List.RemoveFirstN(
{2, 4, 6, 3, 5},
2
)
List
Un clic en el enlace List nos muestra la lista resultante:
Si, usando la misma lista, añadimos como condición que los elementos tengan que ser menores que 6, por ejemplo...
List.RemoveFirstN(
{2, 4, 6, 3, 5},
each _ < 6
)
List
...el resultado es el siguiente:
Vemos que la función ha comenzado a eliminar elementos del comienzo de la lista hasta que ha encontrado el primero que no cumplía la condición (el 6).
Si eliminamos más elementos de los que hay, la función devuelve una lista vacía:
List.RemoveFirstN(
{2, 4, 6, 3, 5},
10
)
List
La lista resultante es la siguiente:
Si no se especifica el argumento countOrCondition, se elimina el primer elemento de la lista:
List.RemoveFirstN(
{"a", "b", "c"}
)
List
La lista resultante es la siguiente:
