void *Prand(LLIST**,void *)
|
R1
Prand( P1,P2 ) |
Recherche
l'élément
P2 dans la liste P1 sans toucher au cuseur.
- En entrée :
- P1 : Adresse d'un pointeur de liste.
- P2 : Adresse Elément recherché.
- En sortie :
(Voir
codes retour)
- R1 :<>0 L'élément existe
dans la liste et R1 = adresse de l'élément.
- R1 : = NULL
n'existe pas dans la liste.
Remarque :
- 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 *)