collection.lastIndexOf( )

4D v19.8


collection.lastIndexOf ( aBuscar {; posicInic} ) -> Resultado

Parâmetro	Tipo	Descrição
aBuscar	Expression	O elemento que será pesquisado de dentro da coleção
posicInic	Inteiro longo	Índice a iniciar a pesquisa
Resultado	Inteiro longo	ìndice da última ocorrência de aBuscar na coleção, -1 se não for encontrado

Descrição

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.

Exemplo

 C_COLLECTION($col)

 $col:=Split string("a,b,c,d,e,f,g,h,i,j,e,k,e";",") //$col.length=13

 $pos1:=$col.lastIndexOf("e") //devolve 12

 $pos2:=$col.lastIndexOf("e";6) //devolve 4

 $pos3:=$col.lastIndexOf("e";15) //devolve 12

 $pos4:=$col.lastIndexOf("e";-2) //devolve 10

 $pos5:=$col.lastIndexOf("x") //devolve -1

Ver também

collection.indexOf( )