DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Position par rapport à une rubrique clé ou non clé
  • Position dans un parcours filtré
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Positionne sur un enregistrement à partir de la position approximative d'une de ses rubriques. L'enregistrement est lu.
Cette fonction peut être utilisée indifféremment avec les fichiers de données, les vues HFSQL ou les requêtes.
Attention : La fonction HPositionne permet uniquement de se positionner. Pour connaître la position en cours, utilisez la fonction HPositionCourante.
HPositionne(Client, Nom, 500)
Syntaxe
<Résultat> = HPositionne(<Fichier de données> [, <Rubrique>] , <Position> [, <Précision>])
<Résultat> : Booléen
  • Vrai si le positionnement a été effectué,
  • Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré. Si aucun enregistrement ne correspond, la fonction HEnDehors renvoie Vrai et aucun enregistrement n'est lu.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données, de la vue ou de la requête manipulé.
Si ce nom n'est pas spécifié, la fonction HPositionne va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Rubrique> : Chaîne de caractères optionnelle
Nom de la rubrique utilisée.
Si ce nom n'est pas spécifié, la fonction HPositionne va manipuler la dernière rubrique utilisée par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Position> : Entier
Position approximative à fixer. Cette position doit être comprise dans l'intervalle [1;1000].
<Précision> : Entier optionnel
Fixe la précision avec laquelle la position est effectuée. Attention : Plus la précision est élevée, et plus le temps de positionnement est important.
hPrécisionElevéePrécision élevée.
hPrécisionFaiblePrécision faible.
hPrécisionMoyenne
(valeur par défaut)
Précision moyenne.
Remarques

Position par rapport à une rubrique clé ou non clé

  • Pour une rubrique clé, la position est relative à l'ordre de l'enregistrement dans l'index de cette rubrique.
  • Pour une rubrique non clé, la position est relative au numéro de l'enregistrement dans le fichier de données (voir la fonction HNumEnr).

Position dans un parcours filtré

Si un filtre avec bornes est défini (la fonction HFiltre sans chaîne de condition mais avec les bornes minimales et maximales), la position est relative aux enregistrements sélectionnés par le filtre.
Si une chaîne de condition est donnée à la fonction HFiltre, la position ne tient pas compte du filtre.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale