GETSEQ

Getseqpermet de lire des données à partir d'un fichier binaire ouvert par Openi ou Openio.

Syntaxe

  Getseqexp_ent, liste_varia [Usingclasse]

Paramètres

Exemples

# Le fichier TEST commence par la suite des lettresde l'alphabet : abcdefghijklmnopqrstuvwxyz
# Lecture à partir du 6ème octet de ce fichier, de 3 éléments.
# Ces éléments sont placés dans une chaîne et un tableau de chaînes de caractères.
Char X(4), Y (5)(9)
Openi filpath("TXT", "TEST",""), 5
Getseq 3, X, Y
Openi
#
# Après ce traitement :

# C omme ci-dessus, le fichier TEST commence par la suite des lettres
# de l'alphabet : abcdefghijklmnopqrstuvwxyz
Char Y(5) (2,3)
Openi filpath("TXT", "TEST","")
Getseq 4, Y(0), Y(1)
#
#  Après ce traitement :

# l'exemple ci-dessus peux aussi s'écrire
Char Y(5) (2,3)
Openi filpath("TXT", "TEST","") Using [ZZZ]
Getseq 4, Y(0), Y(1)Using [ZZZ]

Description et commentaires

Getseqlit dans le dernier fichier ouvert par Openi ou Openio des éléments dont le nombre est donné par exp_ent et les copie dans la liste de variables données en arguments de l'instruction.

La clause Using permet de préciser la classe du fichier séquentiel sur lequel on lit. Il est maintenant possible de traiter plusieurs fichiers séquentiels en même temps.

Lorsqu'il y a des tableaux d'éléments dans la liste, on peut omettre la dernière dimension. Dans le cas de tableaux mono-dimensionnés, on pourra donc indiquer le nom du tableau sans précision d'indice. Les éléments lus dans le fichier sont copiés dans ces variables dans l'ordre croissant de l'indice de la dimension omise jusqu'à épuisement du nombre de valeurs à lire.

Les éléments sont lus selon la structure interne des variables données en arguments. Le tableau suivant donne le format et le nombre d'octets utilisés suivant les types des variables :

Ainsi  qu'on  le  remarque dans ce tableau, les variables de type Date   ont une taille de 3 octets dans la classe [F] (le but étant de prendre  le  moins de place possible dans la table), alors que dans la classe   [V]  ou  [L],  elles  prennent la place d'un entier long. De même, les  nombres décimaux sont automatiquement déclarés avec une taille maximum si on les déclare ailleurs que dans   les  tables. L'écriture de variables de type Float ou Double crée un fichier non portable (de même celle de variables de type Decimal définies dans une classe autre que [F]).

On peut lire un Blob ( et éventuellement un clob ) depuis un fichier séquentiel par l'instruction Getseq.

Remarques

La variable système Adonix fstat est mise à 1 si la lecture a buté sur la fin du fichier.

Les variables qui n'ont pu être affectées par l'instruction Getseq soit parce que l'on a atteint la fin du fichier, soit parce que le nombre d'éléments lus est inférieur au nombre d'éléments donnés en arguments, sont mises à zéro.

Si le nombre d'éléments à lire est supérieur au nombre total des éléments donnés en arguments, aucune erreur n'est signalée.

La fonction adxseek(0) ou adxseek(classe) (pour un fichier ouvert avec une classe) donne à tout moment la position (en nombre d'octets) par rapport au début du fichier. Elle vaut -1 si aucun fichier n'a été ouvert en lecture.

Erreurs associées

Mots-clés associés

OPENI - OPENIO - SEEK - ADXSEEK - PUTSEQ - RDSEQ - WRSEQ - FSTAT

SOMMAIRE