DESCRIPTION.

La fonction OPENIN() ouvre un fichier de données en lecture uniquement et retourne le numéro du canal de communication qui lui sera associé.

SYNTAXE.

kfichier& = OPENIN( fichier )

REMARQUES.

fichier doit être une chaine de caractères, ou une variable de type $, et correspondant au nom d'un fichier valide. fichier peut être exprimé de façon : 

- absolue, indiquant le support, le chemin d'accès, le nom et l'extension du fichier ;

- relative, indiquant son nom et son extension, il est supposé se trouver dans un dossier par défaut.

Note. Il est important de fermer proprement un fichier, avec l'instruction CLOSE #, dès que son utilisation n'est plus requise par le programme. De même, l'instruction END finalisera l'enregistrement des données sur le support non-volatil.

Pour lire des enregistrements présents dans un fichier de données existant, il faut d'abord l'ouvrir en mode lecture seule avec la fonction OPENIN(), ou en mode lecture/écriture avec la fonction OPENUP(), afin d'obtenir son numéro de canal, et de le mémoriser dans une variable.

La fonction OPENIN() ouvre le fichier en lecture seulement. Il ne sera pas possible de modifier les enregistrements ni d'en ajouter. On l'utilisera pour s'assurer qu'il n'y aura pas de modification au fichier lors de son utilisation.

La fonction OPENIN() retourne le numéro du canal de communication associé au fichier. Il est indispensable de mémoriser cette valeur pour pouvoir la transmettre aux instructions de lecture pour obtenir le contenu du fichier. 

On pourra utiliser plusieurs fonctions OPENIN() simultanément pour ouvrir un même fichier pour lire ses données. Par contre, les fonctions OPENOUT() et OPENUP() ne peuvent être associées à un fichier que s'il n'est pas déjà ouvert en écriture.

Notez que le numéro de canal attribué au fichier à sa création et ceux qui lui seront associés lors de ses utilisations suivantes peuvent être différents.

Note : sous Windows de Microsoft, la syntaxe OPENIN( "" ), ou si fichier contient un ? ou un *, une boite de dialogue pour sélectionner le fichier à ouvrir sera affichée.

Voir l'instruction OPENOUT() qui créer un fichier, l'ouvre en écriture et retourne le numéro de canal du fichier.

Voir l'instruction OPENUP() qui ouvre un fichier en lecture/écriture et retourne le numéro de canal du fichier.

Voir le module filedlg.bbc qui propose des fonctions pour sélectionner un fichiers dans un explorateur de fichiers.

RUBRIQUE.

Les fichiers de données pour plus de détails sur la création et l'utilisation des fichiers de données.

EXEMPLE.

REM --- Initialisation ---

kfichier$ = @dir$ + "Tester.txt"

REM --- Création du fichier et enregistrement ---

kfichier& = OPENOUT( kfichier$ )

PRINT #kfichier&, "BBC BASIC SDL 2.0"

PRINT #kfichier&, "Mon BBC BASIC pas a pas"

PRINT #kfichier&, "Origine NERD"

CLOSE #kfichier&

REM --- Lecture des enregistrements avec OPENIN ---

kfichier& = OPENIN( kfichier$ )

INPUT #kfichier&, kdonnee$ : PRINT kdonnee$

INPUT #kfichier&, kdonnee$ : PRINT kdonnee$

INPUT #kfichier&, kdonnee$ : PRINT kdonnee$

CLOSE #kfichier&

REM --- Fin de l'exemple ---

END

retourne :

BBC BASIC SDL

Mon BBC BASIC pas a pas

Origine NERD