Saltar para o conteúdo principal

List.RemoveFirstN

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

Syntax​

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

Remarks​

Devolve uma lista que remove o primeiro elemento da lista list. Se list for uma lista vazia, é devolvida uma lista vazia. Esta função assume um parâmetro opcional, countOrCondition, para suportar a remoção de múltiplos valores, conforme listado abaixo.

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

Examples​

Example #1​

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

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

Result:

{4, 5}

Example #2​

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

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

Result:

{2, 6, 1}

Category​

List.Transformation functions