// Recherche d'un enregistrement
HLitRecherchePremier(CLIENT, NOM, Nom)
TANTQUE HTrouve(CLIENT) = Vrai
// Sauve le contexte en cours
nPos = HSauvePosition(CLIENT, NOM)
// Vérification d'un client d'un autre nom
HLitRecherche(CLIENT, NOM, Nom2)
SI HTrouve() = Vrai ALORS Compteur = Compteur + 1
// Restaure le contexte
HRetourPosition(nPos)
HLitSuivant(CLIENT, NOM)
FIN
Syntaxe
<Résultat> = HRetourPosition(<Position> [, <Option>])
<Résultat> : Booléen
- Vrai si la restauration de la position indiquée a été effectuée,
- Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré.
<Position> : Entier
Position à restaurer. Valeur retournée par la fonction HSauvePosition.
<Option> : Constante ou combinaison de constante optionnelle
Permet de paramétrer la restauration : | |
| hRPConserve | La position n'est pas libérée (d'autres appels à la fonction HRetourPosition pourront être réalisés sur cette position). |
hRPDéfaut
(valeur par défaut) | La position est libérée. La position sauvegardée est restaurée. |
| hRPFiltre | Restaure le filtre posé au moment de l'appel à la fonction HSauvePosition. |
| hRPHF5 | Si la position sauvegardée a été supprimée ou modifiée, cette position est tout de même restaurée.
Si la constante hRPHF5 n'est pas précisée et que la sauvegarde a été réalisée sur plusieurs rubriques, le repositionnement est fait sur le numéro d'enregistrement en cours au moment de l'appel à la fonction HSauvePosition.
|
Remarques
Réinitialisation des positions
Attention : toutes les fonctions entraînant l'ouverture ou la fermeture d'un fichier de données réinitialisent les numéros de contexte (par exemple
HCréation,
HFerme, ...).
Si l'enregistrement sauvegardé par la fonction
HSauvePosition a été supprimé, la fonction
HRetourPosition conservera le contexte en cours mais se positionnera sur l'enregistrement suivant l'enregistrement supprimé.
- Le nombre d'appels à la fonction HSauvePosition n'est pas limité.
- Il est possible d'imbriquer les fonctions HSauvePosition et HRetourPosition pour un même fichier.