Table.RemoveFirstN

Возвращает таблицу с пропущенным определенным количеством строк в начале.

Syntax

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

Remarks

Возвращает таблицу, не содержащую указанное число первых строк (countOrCondition) в таблице table. Количество удаленных строк зависит от необязательного параметра countOrCondition.

• Если countOrCondition не указано, удаляется только первая строка.
• Если countOrCondition — число, удаляется соответствующее количество строк (с начала).
• Если countOrCondition — условие, будут удалены строки, соответствующие условию, до первой строки, не соответствующей условию.

Examples

Example #1

Удаление первой строки таблицы.

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

Удаление первых двух строк таблицы.

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

Удаление из таблицы первых строк, в которых [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