Pular para o conteúdo principal

List.RemoveFirstN

Retorna uma lista que ignora o número especificado de elementos no início da lista.

Syntax

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

Remarks

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é esse número de itens serão removidos.
  • Se uma condição for especificada, todos os itens correspondentes consecutivos no início do list serão removidos.
  • Se esse parâmetro for nulo, o comportamento padrão será observado.

Examples

Example #1

Crie uma lista a partir de {1, 2, 3, 4, 5} sem os três primeiros números.

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

Result:

{4, 5}

Example #2

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

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

Result:

{2, 6, 1}

Category

List.Transformation functions