// Parcours séquentiel pour afficher le nom de tous les clients
i est un entier
POUR i = 1 _À_ HNbEnr(Client, hEtatTous)
HLit(Client, i)
SI HEtat() = hEtatActif ALORS
Info("Nom du client : " + Client.Nom)
FIN
FIN
Syntaxe
<Résultat> = HLit([<Fichier de données> [, <Numéro d'enregistrement> [, <Options>]]])
<Résultat> : Booléen
- Vrai si l'enregistrement a été lu,
- Faux en cas d'erreur (blocage, fin du fichier de données, ...) : l'enregistrement n'est pas lu. La fonction HErreur permet d'identifier l'erreur.
<Fichier de données> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom du fichier de données HFSQL, de la vue ou de la requête manipulé.Si ce paramètre correspond à une chaîne vide (""), la fonction HLit manipule le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Numéro d'enregistrement> : Entier optionnel
Numéro de l'enregistrement à lire.Si ce paramètre n'est pas spécifié (ou est égal à 0 ou à la constante
hNumEnrEnCours), la fonction
HLit va manipuler l'enregistrement en cours.
<Options> : Constante optionnelle
Paramètre le blocage réalisé sur l'enregistrement lu par la fonction HLit : | |
hBlocageNon | Aucun blocage (même si la fonction HDébutVerrou a été appelée) : l'enregistrement pourra être lu ou modifié par une autre application pendant la lecture. |
hBlocageEcriture | Blocage en écriture : l'enregistrement en cours de lecture pourra être lu par une autre application mais ne pourra pas être modifié par une autre application. |
hBlocageLectureEcriture | Blocage en lecture/écriture : l'enregistrement en cours de lecture ne pourra ni être lu ni être modifié par une autre application. |
Remarques
Parcours d'un fichier de données
La fonction
HLit ne permet pas de poursuivre un parcours effectué avec les fonctions
HLitPremier,
HLitSuivant.
Mémos
Les mémos associés à l'enregistrement peuvent être automatiquement lus ou non lors de la lecture de l'enregistrement. La fonction
HGèreMemo permet de personnaliser cette lecture automatique.
Si les mémos sont gérés, lorsque l'enregistrement est lu, les mémos texte associés sont également lus. Les mémos binaires ne sont lus que lorsqu'ils sont utilisés explicitement (fonction
HExtraitMémo).
Divers
Le résultat de la fonction
HTrouve doit être ignoré (la fonction
HTrouve doit être utilisée pour les recherches réalisées avec les fonctions
HLitRecherchePremier et
HLitRechercheDernier).
Le numéro de l'enregistrement en cours est connu avec la fonction
HNumEnr. Le numéro du premier enregistrement du fichier de données est 1.