Share via


Table.RemoveFirstN

Syntaxe

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

À propos

Retourne une table qui ne contient pas le premier nombre spécifié de lignes, countOrCondition, de la table table. Le nombre de lignes supprimées dépend du paramètre facultatif countOrCondition.

  • Si countOrCondition est omis, seule la première ligne est supprimée.
  • Si countOrCondition est un nombre, autant de lignes (en commençant par le haut) sont supprimées.
  • Si countOrCondition est une condition, les lignes qui remplissent la condition sont supprimées jusqu’à ce qu’une ligne ne remplisse pas la condition.

Exemple 1

Supprimer la première ligne de la table.

Utilisation

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
)

Sortie

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

Exemple 2

Supprimer les deux premières lignes de la table.

Utilisation

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
)

Sortie

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

Exemple 3

Supprimer les premières lignes de la table où [CustomerID] <=2.

Utilisation

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
)

Sortie

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