Pular para o conteúdo principal

List.LastN

Retorna o último valor da lista. Opcionalmente, pode especificar quantos valores serão retornados ou uma condição de qualificação.

Syntax​

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

Remarks​

Retorna o último item da lista list. Se a lista estiver vazia, uma exceção será lançada. Esta função assume um parâmetro opcional countOrCondition, a fim de oferecer suporte à coleta de vários itens ou à filtragem de itens. countOrCondition pode ser especificado de três maneiras:

  • Se um número for especificado, essa será a quantidade de itens retornados.
  • Se uma condição for especificada, todos os itens que atenderem inicialmente à condição serão retornados, começando pelo fim da lista. Quando um item não atender à condição, nenhum outro item será considerado.
  • Se esse parâmetro for nulo, o último item da lista será retornado.

Examples​

Example #1​

Localize o último valor da lista {3, 4, 5, -1, 7, 8, 2}.

List.LastN({3, 4, 5, -1, 7, 8, 2}, 1)

Result:

{2}

Example #2​

Localize os últimos valores da lista {3, 4, 5, -1, 7, 8, 2} que sejam maiores que 0.

List.LastN({3, 4, 5, -1, 7, 8, 2}, each _ > 0)

Result:

{7, 8, 2}

Category​

List.Selection