|
|
|
|
|
|
|
|
|
|
HChangeClé (Fonction) En anglais : HChangeKey
 Non disponible avec ce type de connexion
Change la rubrique de parcours. L'enregistrement en cours reste inchangé. Après l'exécution de la fonction, la suite du parcours est réalisée à partir de l'enregistrement en cours, suivant la nouvelle rubrique de parcours. La fonction HChangeClé peut être utilisée par exemple pour amorcer un parcours du fichier de données, après un positionnement sur un enregistrement en accès direct (fonction HLit par exemple). Remarque : Cette fonction peut être utilisée indifféremment sur un fichier de données, une requête ou une vue HFSQL.
SI HChangeClé(Client, Nom) = Faux ALORS
Erreur("Sélectionnez un client dans la table")
FIN
Syntaxe
<Résultat> = HChangeClé(<Fichier de données> [, <Rubrique> [, <Mode de parcours>]])
<Résultat> : Booléen - Vrai si la clé de parcours a été modifiée,
- Faux en cas de problème (aucune fonction de lecture n'a précédé le changement de clé par exemple) : la clé de parcours n'est pas modifiée. La fonction HErreur permet d'identifier l'erreur.
<Fichier de données> : Chaîne de caractères Nom du fichier de données, de la vue HFSQL ou de la requête manipulé. <Rubrique> : Chaîne de caractères optionnelle Nom de la nouvelle rubrique de parcours.
Si ce nom n'est pas spécifié, la fonction HChangeClé va utiliser la dernière rubrique de parcours spécifiée sur ce fichier par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H). <Mode de parcours> : Constante optionnelle de type Entier Caractéristique du parcours du fichier de données sur la nouvelle clé : | | | hRespecteFiltre | Le parcours prendra en compte le filtre mis en place avec la fonction HFiltre, même si la clé de parcours utilisée n'est pas optimisée pour le filtre.
Rappel : la fonction HFiltre renvoie la clé de parcours optimisée pour le filtre.
Attention : Dans ce cas, sur des fichiers de données de taille importante, des problèmes de performances peuvent survenir. |
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|