collection.lastIndexOf( )

4D v19.8


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

Parámetro	Tipo	Descripción
aBuscar	Expresión	Elemento a buscar en la colección
posicIni	Entero largo	Número del elemento a partir del cual iniciar la búsqueda
Resultado	Entero largo	Número de la última ocurrencia de aBuscar en la colección, -1 si no se encuentra

Descripción

El método collection.lastIndexOf( ) busca la expresión aBuscar entre los elementos de la colección y devuelve el índice de la última ocurrencia, o -1 si no se encontró.

Nota: este método no modifica la colección original.

En aBuscar, pase la expresión a buscar en la colección. Puedes pasar:

un valor escalar (texto, número, booleano, fecha),
el valor nulo,
una referencia de objeto o de colección.

aBuscar debe coincidir exactamente con el elemento a buscar (se aplican las mismas reglas que para el operador de igualdad, ver Operadores de comparación).

Opcionalmente, puede efectuar una búsqueda en sentido inverso pasando el número del elemento en el cual iniciar la búsqueda en posicIni.

Si posicIni >= la longitud de la colección menos uno (coll.length-1), se busca en toda la colección (por defecto).
Si posicIni < 0, se recalcula como posicIni :=posicIni +length (el fin de la colección se considera como punto de inicio del calculo de la posición). Si el valor calculado es negativo, se devuelve -1 (la colección no se evalúa).
Nota: incluso si posicIni es negativo, la colección se evalúa de derecha a izquierda.
Si posicIni = 0, -1 se devuelve -1, lo que significa que no se busca la colección.

Ejemplo

 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") //devuelve 12

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

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

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

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

Ver también

collection.indexOf( )