List.RemoveFirstN

语法

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

关于

返回一个列表,该列表删除列表 list 的第一个元素。 如果 list 为空列表,则返回空列表。 此函数采用可选参数 countOrCondition,以支持删除下列的多个值。

  • 如果指定了数字,则最多会删除指定数量的项。
  • 如果指定了条件,则 list 开头任何连续的匹配项都会被移除。
  • 如果此参数为 NULL,则会观察到默认行为。

示例 1

从 {1, 2, 3, 4, 5} 创建不带前 3 个数的列表。

使用情况

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

输出

{4, 5}

示例 2

从 {5, 4, 2, 6, 1} 创建以小于数字 3 开头的列表。

使用情况

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

输出

{2, 6, 1}