4D v17.4

collection.lastIndexOf( )

Página Inicial

 
4D v17.4
collection.lastIndexOf( )

collection.lastIndexOf( )  


 

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( )

 
PROPRIEDADES 

Produto: 4D
Tema: Coleções

This command can be run in preemptive processes

 
CONTEÚDO DA PÁGINA 
 
HISTÓRIA 

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v17)
Manual de linguagem 4D ( 4D v17.1)
Manual de linguagem 4D ( 4D v17.2)
Manual de linguagem 4D ( 4D v17.3)
Manual de linguagem 4D ( 4D v17.4)