FMOVE

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

Déplace un fichier d'une source vers une destination.

Support WebVue - Oui.

Syntaxe

IntVal = FMOVE (ExistingFileName, NewFileName[, AllowOverwrite]);

Argument

Définition

ExistingFileName

Nom et chemin optionnel du fichier source. 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.

NewFileName Nom et chemin optionnel du fichier destination. 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.
AllowOverwrite Flag autorisant l'écrasement d'un fichier ayant le même nom.
0 = Ne pas autoriser.
1 = Autoriser.

Exécution

Déplace le fichier spécifié. Le flag optionnel AllowOverwrite peut être utilisé afin de permettre à un fichier existant d'être écrasé par un autre fichier ayant le même nom.

Retour :
1 - OK.
0 - Echec. Le fichier source n'existe pas ou est ouvert et verrouillé par une autre application.
-1 - Echec. Le fichier destination existe déjà et AllowOverwrite est positionné à 0.
-2 - Echec. Le fichier source est déjà ouvert par SCADA Basic (instruction Fopen).

Plus d'informations

ExistingFileName et NewFileName peuvent être soit juste un nom de fichier, soit inclure un chemin complet ou relatif. Si un chemin n'est pas inclus, l'exécution aura lieu dans le dossier TP du projet. Si un chemin est inclus dans NewFileName et que le dossier n'existe pas, il sera alors créé.

Exemples

Nom du fichier

Exemple

Nom du fichier MyFile.dat
Avec le chemin complet C:\\temp\\MyFile.dat
Avec le chemin relatif ..\\..\\Files\\MyFile.dat

Notez la nécessité d'utiliser un double anti-slash comme séparateur de dossier.