Table.RemoveFirstN

Devolve uma tabela com as primeiras linhas de contagem ignoradas.

Syntax

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

Remarks

Devolve uma tabela que não contém o primeiro número de linhas especificado, countOrCondition, da tabela table. O número de linhas removidas depende do parâmetro opcional countOrCondition.

• Se countOrCondition for omitido, só é removida a primeira linha.
• Se countOrCondition for um número, será removido esse número de linhas (a partir do início).
• Se countOrCondition for uma condição, serão removidas as linhas que satisfaçam a condição até que uma linha não satisfaça a condição.

Examples

Example #1

Remover a primeira linha da tabela.

Table.RemoveFirstN(
    Table.FromRecords({
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
        [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
    }),
    1
)

Result:

Table.FromRecords({
    [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
    [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})

Example #2

Remover as primeiras duas linhas da tabela.

Table.RemoveFirstN(
    Table.FromRecords({
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
        [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
    }),
    2
)

Result:

Table.FromRecords({
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
    [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})

Example #3

Remover as primeiras linhas em que [CustomerID] <=2 da tabela.

Table.RemoveFirstN(
    Table.FromRecords({
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
        [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
    }),
    each [CustomerID] <= 2
)

Result:

Table.FromRecords({
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
    [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})

Category

Table.Row operations