Este es el sitio web histórico de la documentación de 4D. La documentación se está trasladando progresivamente a developer.4d.com

Inicio

 
4D v19.8
collection.indexOf( )

collection.indexOf( ) 


 

collection.indexOf ( aBuscar {; posicIni} ) -> Resultado 
Parámetro Tipo   Descripción
aBuscar  Expresión in Elemento a buscar en la colección
posicIni  Entero largo in Número del elemento a partir del cual iniciar la búsqueda
Resultado  Entero largo in Número de la primera ocurrencia de aBuscar en la colección, -1 si no se encuentra

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
Número 805255

This command can be run in preemptive processes

 
CONTENIDO DE LA PÁGINA 
 
HISTORIA 

Creado por: 4D v16 R6

 
ARTICLE USAGE

Manual de lenguaje 4D ( 4D v19)
Manual de lenguaje 4D ( 4D v19.1)
Manual de lenguaje 4D ( 4D v19.4)
Manual de lenguaje 4D ( 4D v19.5)
Manual de lenguaje 4D ( 4D v19.6)
Manual de lenguaje 4D ( 4D v19.7)
Manual de lenguaje 4D ( 4D v19.8)