Partilhar via


Table.RemoveFirstN

Sintaxe

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

Acerca de

Retorna uma tabela que não contém o primeiro número especificado de linhas, , countOrConditionda tabela table. O número de linhas removidas depende do parâmetro countOrConditionopcional.

  • Se countOrCondition for omitida, apenas a primeira linha será removida.
  • Se countOrCondition for um número, muitas linhas (começando no topo) serão removidas.
  • Se countOrCondition for uma condição, as linhas que atendem à condição serão removidas até que uma linha não atenda à condição.

Exemplo 1

Remova a primeira linha da tabela.

Utilização

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
)

Saída

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

Exemplo 2

Remova as duas primeiras linhas da tabela.

Utilização

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
)

Saída

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

Exemplo 3

Remova as primeiras linhas onde [CustomerID] <=2 da tabela.

Utilização

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
)

Saída

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