collection.lastIndexOf( )

4D v19.8


collection.lastIndexOf ( àChercher {; positionDépart} ) -> Résultat

Paramètre	Type	Description
àChercher	Expression	Elément à chercher dans la collection
positionDépart	Entier long	Numéro d'élément à partir duquel débuter la recherche
Résultat	Entier long	Numéro de la dernière occurrence de àChercher dans la collection, -1 si non trouvée

Description

La méthode collection.lastIndexOf( ) recherche l'expression àChercher parmi les éléments de la collection et retourne le numéro d'élément de la derniè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 effectuer une recherche en sens inverse en passant 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), l'ensemble de la collection est évalué (défaut).
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). Si la position calculée est négative, -1 est retourné (la collection n'est pas évaluée).
Note : Même si positionDépart est négatif, la collection est évaluée de la droite vers la gauche.
Si positionDépart = 0, -1 est retourné (la collection n'est pas évaluée).

Exemple

 C_COLLECTION($col)

 $col:=Séparer chaine("a,b,c,d,e,f,g,h,i,j,e,k,e";",") //$col.length=13

 $pos1:=$col.lastIndexOf("e") // retourne 12

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

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

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

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

Voir aussi

collection.indexOf( )