Skip to main content

List.RemoveLastN

Returns a list that removes the specified number of elements from the end of the list.

Syntax

List.RemoveLastN(
list as list,
optional countOrCondition as any
) as list

Remarks

Returns a list that removes the last countOrCondition elements from the end of list list. If list has less than countOrCondition elements, an empty list is returned.

  • If a number is specified, up to that many items are removed.
  • If a condition is specified, the returned list ends with the first element from the bottom in list that meets the criteria. Once an item fails the condition, no further items are considered.
  • If this parameter is null, only one item is removed.

Examples

Example #1

Create a list from {1, 2, 3, 4, 5} without the last 3 numbers.

List.RemoveLastN({1, 2, 3, 4, 5}, 3)

Result:

{1, 2}

Example #2

Create a list from {5, 4, 2, 6, 4} that ends with a number less than 3.

List.RemoveLastN({5, 4, 2, 6, 4}, each _ > 3)

Result:

{5, 4, 2}

Category

List.Transformation functions