FOPEN

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple

Ouvre le fichier spécifié selon le mode d'accès spécifié.

Support WebVue - Oui.

Avant d'utiliser une des instructions de gestion de fichiers, exceptés FSTAT, RENAME, UNLINK, FILETOBUF ou BUFTOFILE, vous devez ouvrir en premier lieu le fichier en utilisant l'instruction FOPEN.

A la fin de chaque programme utilisant une instruction FOPEN vous devez exécuter l’instruction FCLOSE.

Syntaxe

IntVal = FOPEN(Filename, Access);

Type de retour : INTEGER

Argument

Définition

Filename

Nom du fichier à ouvrir. Type STR.
Si exécutée dans le contexte d'une session WebVue, cette instruction est traitée par le back end web, en conséquence de quoi le fichier doit exister sur la machine back end web.

Access

Mode d'accès pour la fonction d'ouverture. Type STR.

r

Ouvre un fichier texte pour lecture.

w

Crée un fichier texte et ouvrez-le en écriture. Écrase un fichier existant du même nom.

a

Ouvre un fichier existant en mode lecture et écriture et se positionne à la fin du fichier.

r+

Ouvre un fichier texte en mode lecture et écriture.

w+

Crée un fichier texte et l'ouvre en mode lecture et écriture ; écrase le contenu précédent si le fichier existait. Écrase un fichier existant du même nom.

a+

Ouvre ou crée un fichier texte et se positionne en écriture à la fin du fichier.

b

Ouvre un fichier en mode binaire.

Exécution

Un fichier est ouvert avec le mode d'accès donné.

Retour :

1 si OK, 0 sinon.

Tous les fichiers ouverts par SCADA BASIC doivent résider dans le dossier TP du projet.

Une ouverture non réussie peut être fatale si l'on tente par la suite d'exécuter des lectures sur le fichier.

Lorsque le fichier est en mode texte, les caractères saut de ligne (LF) du buffer sont transformés en CRLF sur le fichier.

Exemple

Le répertoire par défaut est le répertoire TP du projet courant.

'write file histo.fil in the TP folder

i1 = FOPEN("histo.fil","w+");

'read file in the C:\Test folder

i1 = FOPEN("C:\\TEST\\histo.fil","r");