Note :

Il offre les fonctions suivantes:

• readfile : renvoie le contenu d'un fichier
• writefile : écriture d'un fichier
• delete_files : effacer un fichier ou un répertoire récursivement
• copy : copie un fichier ou un répertoire récursivement
• getwebfile : chargement d'un fichier distant

readfile

La fonction prend un seul argument :

• le nom du fichier texte à lire

Elle retourne le contenu du fichier.

Code d'erreur renvoyé par la fonction :

• -1 : impossible d'ouvrir le fichier

Exemple d'utilisation de la fonction :

~readfile("liste.dat")

writefile

La fonction prend 2 arguments :

• Le nom du fichier (chemin complet)
• Le contenu à écrire dans le fichier

NOTE: si le fichier existe déjà, il est écrasé et ~writefile() y insère le nouveau contenu.

Code d'erreur renvoyé par la fonction :

• -1 : impossible d'ouvrir le fichier en écriture
• -2 : un problème est survenu pendant l'écriture du fichier

Exemple d'utilisation de la fonction :

~writefile("liste.dat", "foobar")

delete_files

La fonction prend 1 argument

• le fichier ou le répertoire à effacer récursivement

Le format PCRE peut-être utilisé. Il peut aussi prendre en argument un tableau, il effacera tous les fichiers décrits dans le tableau.

Exemple d'utilisation de la fonction :

~delete_files("tmp/.*/.*\.html")

copy

La fonction ~copy peut prendre deux ou trois arguments :

• from : le fichier ou le répertoire source
• to : le répertoire destination
• safe : si la valeur est 1 alors la fonction sauvegarde les fichiers existants lors de la copie des fichiers. Si la valeur est -1 alors la fonction écrasera les fichiers existants lors de la copie des fichiers. (argument optionel)

La fonction copie récursivement.

Lorsque le paramètre safe est activé, la fonction renvoie la liste des fichiers qui ont été sauvegardés.

La fonction ne renvoie aucun code d'erreur

Exemple d'utilisation de la fonction :

~copy("template/", "backup/", 1)

getwebfile

Cette fonction permet le chargement d'un fichier distant ("http://").

• directory : nom du répertoire où enregistrer le fichier téléchargé
• url : url du fichier à télécharger

Si le paramètre directory est vide (""), alors le contenu du fichier téléchargé est directement renvoyé par la fonction. Si le paramètre directory n'est pas vide, la fonction renvoie le nom du fichier chargé.

Code d'erreur renvoyé par la fonction :

• -1 : impossible de charger le fichier
• -2 : erreur lors de l'écriture du fichier téléchargé

Exemple d'utilisation de la fonction ~getwebfile :

~getwebfile('', 'http://www.templeet.org/')