Table.RemoveFirstN

About

Returns a table with the specified number of rows removed from the table starting at the first row. The number of rows removed depends on the optional countOrCondition parameter.

Syntax

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

Arguments

Argument Description
table The Table to remove rows from.
optional countOrCondition Optional number of rows or condition to remove rows, default is 1

Remarks

  • If countOrCondidtion is omitted only the first row is removed

  • If countOrCondidtion is a number, that many rows (starting from the top) will be removed)

  • If countOrCondidtion is a condition, the rows that meet the condition will be removed until a rows does not meet the condition

Example

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)  
CustomerID Name Phone
3 Paul 543-7890
4 Ringo 232-1550
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)  
CustomerID Name Phone
3 Paul 543-7890
4 Ringo 232-1550