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 utiliza um parâmetro opcional, countOrCondition, para suportar a remoção de vários valores, conforme listado abaixo.

  • Se for especificado um número, é removido até esse número de itens.
  • Se for especificada uma condição, a lista devolvida começa pelo primeiro elemento de list que satisfaça os critérios. Quando um item não satisfizer a condição, não serão considerados mais itens.
  • Se este parâmetro for nulo, será observado o comportamento predefinido.

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