List.RemoveFirstN
List.RemoveFirstN(list as list, optional countOrCondition as any) as list
Returns a list that removes the first element of list list
. If list
is an empty list an empty list is returned. This function takes an optional parameter, countOrCondition
, to support removing multiple values as listed below.
- If a number is specified, up to that many items are removed.
- If a condition is specified, any consecutive matching items at the start of
list
are removed. - If this parameter is null, the default behavior is observed.
Create a list from {1, 2, 3, 4, 5} without the first 3 numbers.
Usage
List.RemoveFirstN({1, 2, 3, 4, 5}, 3)
Output
{4, 5}
Create a list from {5, 4, 2, 6, 1} that starts with a number less than 3.
Usage
List.RemoveFirstN({5, 4, 2, 6, 1}, each _ > 3)
Output
{2, 6, 1}