// 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
Restaurer la position spécifiée Masquer les détails
<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.
|
Restaurer un fichier de données Masquer les détails
<Résultat> = HRetourPosition([<Fichier de données>])
<Résultat> : Booléen
- Vrai si la restauration du contexte a été effectuée,
- Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré.
<Fichier de données> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom du fichier de données dont le contexte doit être restauré. Si ce nom n'est pas spécifié, la fonction HRetourPosition va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
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é.
Divers
- 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 de données.
Classification Métier / UI : Code métier