collection.indexOf( )

4D v19.8


collection.indexOf ( toSearch {; startFrom} ) -> Résultat

Paramètre	Type	Description
toSearch	Expression	Expression to search in the collection
startFrom	Entier long	Index to start the search at
Résultat	Entier long	Numéro de la première occurrence de àChercher dans la collection, -1 si non trouvée

Description

La méthode collection.indexOf( ) recherche l'expression àChercher parmi les éléments de la collection et retourne le numéro d'élément de la première occurrence trouvée, ou -1 si aucune occurrence n'a été trouvée.

Note : Cette méthode ne modifie pas la collection d'origine.

Dans àChercher, passez l'expression à rechercher dans la collection. Vous pouvez passer :

une valeur scalaire (texte, nombre, booléen, date),
la valeur null,
une référence d'objet ou de collection.

àChercher doit correspondre exactement à l'élément recherché (les mêmes règles que pour l'opérateur d'égalité sont appliquées, cf. Opérateurs de comparaison).

Optionnellement, vous pouvez passer le numéro de l'élément auquel démarrer la recherche dans positionDépart.

Si positionDépart >= taille de la collection (coll.length-1), la valeur -1 est retournée (la collection n'est pas évaluée).
Si positionDépart < 0, le paramètre est recalculé comme positionDépart:=positionDépart+length (la fin de la collection est considérée comme point de départ du calcul de la position).
Note : Même si positionDépart est négatif, la collection est évaluée de la gauche vers la droite.
Si positionDépart = 0, - l'ensemble de la collection est évalué (défaut).

Exemple

 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

Voir aussi

collection.lastIndexOf( )