Table.RemoveFirstN

Syntax

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

Info

Gibt eine Tabelle zurück, die die angegebene Anzahl der ersten Zeilen countOrCondition der Tabelle table nicht enthält. Die Anzahl der entfernten Zeilen hängt vom optionalen Parameter countOrCondition ab.

• Wenn countOrCondition weggelassen wird, wird nur die erste Zeile entfernt.
• Wenn countOrCondition eine Zahl ist, wird die entsprechende Anzahl Zeilen (oben beginnend) entfernt.
• Wenn countOrCondition eine Bedingung ist, werden die Zeilen, die die Bedingung erfüllen, entfernt, bis eine Zeile die Bedingung nicht erfüllt.

Beispiel 1

Entfernt die erste Zeile der Tabelle.

Verwendung

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
)

Ausgabe

Table.FromRecords({
    [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
    [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})

Beispiel 2

Entfernt die ersten beiden Zeilen der Tabelle.

Verwendung

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
)

Ausgabe

Table.FromRecords({
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
    [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})

Beispiel 3

Entfernt die ersten Zeilen in der Tabelle, die die Bedingung '[CustomerID] <= 2' erfüllen.

Verwendung

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
)

Ausgabe

Table.FromRecords({
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
    [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})