Table of contents
TOC
Collapse the table of content
Expand the table of content

Table.RemoveFirstN

Owen Duncan|Last Updated: 4/19/2018

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.

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

Arguments

ArgumentDescription
tableThe Table to remove rows from.
optional countOrConditionOptional 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)  
CustomerIDNamePhone
3Paul543-7890
4Ringo232-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)  
CustomerIDNamePhone
3Paul543-7890
4Ringo232-1550
© 2018 Microsoft