4D v17.4

collection.indexOf( )

Inicio

 
4D v17.4
collection.indexOf( )

collection.indexOf( )  


 

El método collection.indexOf( ) busca la expresión aBuscar entre los elementos de la colección y devuelve el número del elemento de la primera ocurrencia encontrada, o -1 si no se encuentra.

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 null,
  • un objeto o una referencia 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 pasar el número del elemento desde el cual iniciar la búsqueda en posicIni.

  • Si posicIni >= longitud de la colección, se devuelve -1, lo que significa que no se busca en la colección.
  • Si posicIni < 0, el fin de la colección se considera como punto de inicio del cálculo de la posición (posicIni :=posicIni +length).
    Nota: incluso si posicIni es negativo, la colección se sigue buscando de izquierda a derecha.
  • Si posicIni = 0, se busca en toda la colección (por defecto).

Ejemplo  

 C_COLLECTION($col)
 $col:=New collection(1;2;"Henry";5;3;"Albert";6;4;"Alan";5)
 $i:=$col.indexOf(3) //$i=4
 $i:=$col.indexOf(5;5) //$i=9
 $i:=$col.indexOf("al@") //$i=5
 $i:=$col.indexOf("Hello") //$i=-1



Ver también 

collection.lastIndexOf( )

 
PROPIEDADES 

Producto: 4D
Tema: Colecciones

This command can be run in preemptive processes

 
CONTENIDO DE LA PÁGINA 
 
HISTORIA 

 
ARTICLE USAGE

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