Table.RemoveFirstN

スキップされた最初のカウント行を含むテーブルを返します。

Syntax

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

Remarks

テーブル table の最初の指定された数の行 (countOrCondition) が含まれないテーブルを返します。 削除される行の数は、省略可能なパラメーター 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

テーブルの先頭の 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