4D v18

collection.indexOf( )

Accueil

 
4D v18
collection.indexOf( )

collection.indexOf( )  


 

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:=Creer 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( )

 
PROPRIÉTÉS 

Produit : 4D
Thème : Collections
Nom intl. : collection.indexOf( )

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
PAGE CONTENTS 
 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v18)