Pular para o conteúdo principal

Table.RemoveFirstN

Retorna uma tabela com as primeiras linhas de contagem ignoradas.

Syntax

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

Remarks

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

  • Se countOrCondition for omitido, somente a primeira linha será removida.
  • Se countOrCondition for um número, essas várias linhas (começando na parte superior) serão removidas.
  • Se countOrCondition for uma condição, as linhas que atenderem à condição serão removidas até que uma linha não esteja em conformidade com 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 duas primeiras 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 da tabela as primeiras linhas em que [CustomerID] <=2.

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