List.RemoveFirstN

Sintaxe

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

Sobre

Retorna uma lista que remove o primeiro elemento da lista list. Se list for uma lista vazia, uma lista vazia será retornada. Essa função usa um parâmetro opcional, countOrCondition, para dar suporte à remoção de vários valores, conforme listado abaixo.

  • Se um número for especificado, até que esse número de itens seja removido.
  • Se uma condição for especificada, todos os itens correspondentes consecutivos no início de list serão removidos.
  • Se esse parâmetro for nulo, o comportamento padrão será observado.

Exemplo 1

Crie uma lista com base em {1, 2, 3, 4, 5} sem os três primeiros números.

Usage

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

Saída

{4, 5}

Exemplo 2

Crie uma lista com base em {5, 4, 2, 6, 1} que comece com um número menor que 3.

Usage

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

Saída

{2, 6, 1}