fstat
fstat permet de connaître le statut de retour d'une opération sur fichier ou d'une instruction de verrouillage.
Exemples
# Lecture d'un enregistrementRead [CLI]CODE = 123
If fstat = 0 : Infbox "Lecture OK" : Endif
# Verrouillage d'un symbole : attention, on boucle indéfiniment
# tant que le symbole est verrouillé par un autre utilisateur !Repeat Lock ABC Until fstat = 0
# Lecture séquentielle d'un fichier
Repeat
Rdseq LIGNE(I) I += 1Until I >= dim(LIGNE)| fstat <> 0
Description
fstat permet de connaître le résultat d'une opération sur un fichier séquentiel indexé (lecture, écriture ou verrouillage), un fichier séquentiel (lecture) ou du verrouillage d'un symbole (Lock). fstat vaut toujours 0 si l'opération s'est bien terminée et une valeur non nulle sur erreur :
- en lecture séquentielle (Getseq, Rdseq), fstat vaut 1 en fin de fichier,
- sur Lock, fstat vaut 1 si le verrouillage n'a pu être fait,
- dans le cas d'une opération sur un fichier séquentiel indexé (Read, Look, Readlock, For, Write, Delete, Rewrite), les statuts d'erreur vont de 1 à 5, ainsi que le résume le tableau suivant :
Valeur | fstat | Explication |
1 | ERLOCK | L'enregistrement est verrouillé. |
2 | ERECIND | En mode de lecture <= ou >= , signale que la lecture a eu lieu, mais que la clé trouvée est < ou > à la valeur recherchée. |
3 | ERDUPCL | Tentative de création d'une clé dupliquée; |
4 | ERDEBF | Tentative de lecture d'une clé inférieure ou supérieure à toutes les clés du fichier (début/fin du fichier) ou de la sélection. |
5 | ERPALEC | Enregistrement non lu (signale qu'il n'y a pas d'enregistrement courant). |