Compartilhar via


List.LastN

Sintaxe

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

Sobre

Retorna o último item da lista list. Se a lista estiver vazia, uma exceção será gerada. Essa função usa um parâmetro opcional, countOrCondition, para dar suporte à coleta de vários itens ou à filtragem de itens. countOrCondition pode ser especificado de três maneiras:

  • Se um número for especificado, até que esse número de itens seja retornado.
  • Se uma condição for especificada, serão retornados todos os itens que atendam inicialmente à condição, começando no fim da lista. Quando um item falha na condição, nenhum outro item é considerado.
  • Se esse parâmetro for nulo, o último item da lista será retornado.

Exemplo 1

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

Usage

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

Saída

{2}

Exemplo 2

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

Usage

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

Saída

{7, 8, 2}