O método collection.lastIndexOf( ) busca a expressão aBuscar entre os elementos da coleção e devolve o índice da última ocorrência, ou -1 se não for encontrado.
Nota: este método não modifica a coleçã original.
Em aBuscar, passe a expressão a buscar na coleção. Pode passar:
- um valor escalar (texto, número, booleano, data),
- o valor nulo,
- uma referência de objeto ou de coleção.
aBuscar deve coincidir exatamente com o elemento a buscar (são aplicadas as mesmas regras que para o operador de igualdade, ver Operadores de Comparação).
Opcionalmente, pode efetuar uma pesquisa em sentido inverso passando o número do elemento no qual iniciar a pesquisa em posicIni.
- Se posicIni >= a longitude da coleção menos um (coll.length-1), se busca em toda a coleção (padrão).
- Se posicIni < 0, se recalcula como posicIni :=posicIni +length (o final da coleção se considera como ponto de inicio do cálculo da posição). Se o valor calculado for negativo, se devolve -1 (a coleção não é avaliada).
Nota: mesmo se posicIni for negativo, a coleção é avaliada de direita a esquerda. - Se posicIni = 0, -1 se devolve -1, o que significa que não se busca a coleção.