La función Table.RemoveFirstN devuelve una tabla tras eliminar las primeras N filas o las primeras filas que satisfagan una cierta condición.
Table.RemoveFirstN(
table as table,
optional countOrCondition as any
) as table
- table: tabla de la que eliminar las primeras filas
- countOrCondition: (opcional) número de filas a eliminar o condición que deberán satisfacer para ser eliminadas
Si el argumento countOrCondition es un valor numérico, se eliminará dicho número de filas del comienzo de la tabla. Si se eliminan más filas de las que hay, se devuelve una tabla vacía.
Si se trata de una condición, la función eliminará las filas del comienzo de la tabla que la satisfagan hasta que encuentre la primera que no lo haga.
Si se especifica 0 como número de filas a eliminar, o si ninguna fila satisface la condición indicada, la función devuelve la tabla original.
Si no se especifica el argumento countOrCondition, se elimina la primera fila de la tabla.
En este ejemplo partimos de la siguiente tabla:
let
table = Table.FromRecords(
{
[id = 1, name = "John", age = 38],
[id = 2, name = "Alicia", age = 56],
[id = 3, name = "Marta", age = 28],
[id = 4, name = "Alfonso", age = 62]
}
)
in
table
...y queremos eliminar la primera fila, lo que podemos conseguir con el siguiente código:
let
table = Table.FromRecords(
{
[id = 1, name = "John", age = 38],
[id = 2, name = "Alicia", age = 56],
[id = 3, name = "Marta", age = 28],
[id = 4, name = "Alfonso", age = 62]
}
)
in
Table.RemoveFirstN(
table
)
Siguiendo con el mismo ejemplo, podemos eliminar un número concreto de filas del comienzo de la tabla añadiendo como segundo argumento dicho número:
let
table = Table.FromRecords(
{
[id = 1, name = "John", age = 38],
[id = 2, name = "Alicia", age = 56],
[id = 3, name = "Marta", age = 28],
[id = 4, name = "Alfonso", age = 62]
}
)
in
Table.RemoveFirstN(
table,
2
)
Si, en lugar de un número entero, incluimos una condición como segundo argumento, la función eliminará las filas del comienzo de la tabla que cumplan dicha condición hasta que encuentre la primera que no lo haga, en cuyo caso termina la eliminación:
let
table = Table.FromRecords(
{
[id = 1, name = "John", age = 38],
[id = 2, name = "Alicia", age = 56],
[id = 3, name = "Marta", age = 28],
[id = 4, name = "Alfonso", age = 62]
}
)
in
Table.RemoveFirstN(
table,
each [age] > 30
)