void *PCrand(LLIST**,void *)

En entrée :

• P1 : Adresse d'un pointeur de liste.( LLIST **).
• P2 : Elément recherché.

En sortie : (Voir codes retour)

• R1 :<>0 L'élément existe dans la liste et le curseur est positionné sur celui-ci R1 = adresse de l'élément.
• R1 : = NULL n'existe pas dans la liste.

Remarque :  

• Si l'élément recherché se trouve dans la liste le curseur pointe sur celui-ci, il s'agit d'une recherche séquentielle du premier vers le dernier. Si l'élément existe plusieurs fois dans la liste, la fonction positionnera toujours le curseur sur le premier qu'elle trouve à condition que la clés corresponde !!. Au programmeur de savoir comment il a construit sa liste ( Pour construire une liste ou chaque élément est unique voir la fonction : luajout ). Si l'on désire connaitre combien de fois un élément se trouve dans la liste voir : lcount.
• La fonction Crand utilise les clés. Donc il est nécessaire de savoir si l'on travail avec la clés de la fonction initlist ou une des clés définies avec la fonction lkey ( voir point suivant).
• Ne pas oublier de renseigner ( si on travail avec un structure) l'ensemble des champs faisant partis de la clés.
• Tester le pointeur R1 avant utilisation.

Garantie:

• Retourne l' adresse de l'élément si celui-ci existe.

Voir aussi :  exemple  000


Crand(LLIST **,void *)