Table.RemoveFirstN

La función Table.RemoveFirstN devuelve una tabla tras eliminar las primeras N filas o las primeras filas que satisfagan una cierta condición.

Sintaxis

Table.RemoveFirstN(
    table as table,
    optional countOrCondition as any
) as table

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

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.

Ejemplos

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

Función M Table.RemoveFirstN

...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
    )

Función M Table.RemoveFirstN

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
    )

Función M Table.RemoveFirstN

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
    )

Función M Table.RemoveFirstN
Categoría
Funciones de tabla
Enviado por admin el Dom, 23/08/2020 - 13:55