List.RemoveFirstN

La función List.RemoveFirstN devuelve una lista tras eliminar los primeros N elementos o los primeros elementos que satisfagan una cierta condición.

Sintaxis

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

Parámetros
  • 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
Información adicional

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.

Ejemplos

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

Función M List.RemoveFirstN

Un clic en el enlace List nos muestra la lista resultante:

Función M List.RemoveFirstN

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

Función M List.RemoveFirstN

...el resultado es el siguiente:

Función M List.RemoveFirstN

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

Función M List.RemoveFirstN

La lista resultante es la siguiente:

Función M List.RemoveFirstN

Si no se especifica el argumento countOrCondition, se elimina el primer elemento de la lista:

List.RemoveFirstN(
    {"a", "b", "c"}
)

List

Función M List.RemoveFirstN

La lista resultante es la siguiente:

Función M List.RemoveFirstN
Categoría
Funciones de lista
Enviado por admin el Mié, 29/07/2020 - 14:55