DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Remarque : Ces fonctions sont également disponibles en syntaxe préfixée (Fonctions de gestion des répertoires et des fichiers externes (syntaxe préfixée)).
Les fonctions de gestion des fichiers externes sont les suivantes :
fAjouteBufferAjoute le contenu d'un buffer à la fin d'un fichier.
fAjouteTexteAjoute le contenu d'une chaîne de caractères à la fin d'un fichier.
fAttributRenvoie ou modifie les attributs d'un fichier.
fAttributLectureSeuleIndique si un fichier est en lecture seule et change l'attribut lecture seule d'un fichier.
fBloqueBloque entièrement ou partiellement un fichier externe.
fChangeExtensionChange l'extension d'un fichier présent sur un disque.
fChangeTailleChange la taille d'un fichier externe.
fChargeBufferCharge le contenu d'un fichier externe (texte, image, ...) dans une variable de type buffer.
fChargeRessourceCharge le contenu d'une ressource depuis une bibliothèque.
fChargeTexteCharge le contenu d'un fichier texte dans tout champ ou variable texte (variable de type chaîne, champ de saisie d'une fenêtre, un champ Libellé d'un état, etc.).
fCheminCourtRenvoie le chemin complet court d'un fichier ou d'un répertoire.
fCheminLongRenvoie le chemin complet long d'un fichier ou d'un répertoire.
fChercheCherche une chaîne de caractères ou un buffer dans un fichier ouvert avec la fonction fOuvre.
fCompacteCompresse un fichier.
fCompareCompare bit à bit le contenu de deux fichiers.
fConstruitCheminConstruit un chemin de fichier complet à partir du répertoire et du nom court d'un fichier. Cette fonction permet notamment d'obtenir un nom de fichier valide sans se préoccuper de savoir si des séparateurs sont présents dans le chemin ('/' ou '\') ou de leur sens selon la plateforme.
fContentTypeRenvoie le type d'un fichier selon la norme MIME (Multipurpose Internet Mail Extensions).
fCopieFichierCopie un ou plusieurs fichiers (quels que soient leurs attributs).
fCopieFichierRépertoireWebCopie un fichier image depuis le répertoire des données de l'application (ou un de ses sous-répertoires) vers le répertoire "_WEB" de l'application (ou un de ses sous-répertoires).
fCréeCrée un fichier externe.
fCréeLienCrée un lien sur un fichier à l'emplacement spécifié.
fCrypteCrypte un fichier sous forme binaire ou ASCII.
fDateRenvoie ou modifie les différentes dates d'un fichier ou d'un répertoire (date de création, de modification ou d'accès).
fDateHeureRenvoie ou modifie les différentes dates et heures d'un fichier ou d'un répertoire (date de création, de modification ou d'accès).
fDébloqueDébloque entièrement ou partiellement un fichier externe.
fDécompacteDécompresse un fichier préalablement compressé par fCompacte.
fDécoupeDécoupe un fichier en plusieurs fichiers.
fDécrypteDécrypte un fichier préalablement crypté par fCrypte.
fDéplaceFichierDéplace un fichier d'un répertoire dans un autre.
fDétecteStockageAmovibleDétecte si une unité de stockage amovible (par exemple CD, clé USB, appareil photo USB, ...) a été ajoutée ou enlevée.
fDisqueEnCoursRenvoie ou modifie le disque en cours.
fDisqueInfoRenvoie des informations sur un disque.
fDisquePrêtPermet de savoir :
  • si le lecteur de carte, CD ou DVD est disponible,
  • si le disque existe.
fEcritÉcrit :
  • une chaîne de caractères dans un fichier externe.
  • une portion de mémoire.
fEcritLigneÉcrit une ligne dans un fichier texte (au format ANSI ou UNICODE).
fEstUneImagePermet de savoir si un fichier présent sur disque ou un fichier contenu dans un buffer correspond à un format d'image reconnu par WINDEV, WEBDEV ou WINDEV Mobile.
fExtraitCheminRenvoie les différents éléments d'un chemin : disque, répertoire(s), nom et extension du fichier.
fExtraitRessourceExtrait une ressource de l'application dans un emplacement physique de l'appareil.
fFermeFerme un fichier externe.
fFichierExisteTeste l'existence d'un fichier externe.
fFichierTempRenvoie le nom d'un fichier temporaire unique.
fFiltreImageRenvoie la liste des formats d'images gérés par la plateforme en cours, au format attendu par le filtre de la fonction fSélecteur.
fHeureRenvoie ou modifie les différentes heures d'un fichier ou d'un répertoire (heure de création, de modification ou d'accès).
fInsèreTexteAuDébutInsère un texte au début d'un fichier sans écraser le texte déjà présent dans le fichier.
fListeDisqueRenvoie la liste des disques installés sur la machine.
fListeFichierListe les fichiers d'un répertoire et retourne la liste des fichiers listés.
fListeRépertoireListe les sous-répertoires d'un répertoire donné et retourne les chemins complets des sous-répertoires listés.
fListeRessourceListe les ressources intégrées à l'application.
fLitLit :
  • un bloc d'octets (bloc de caractères) dans un fichier externe (ANSI ou Unicode),
  • le contenu d'un fichier externe (ANSI ou Unicode) pour l'affecter dans une portion de mémoire.
fLitLigneLit une ligne dans un fichier externe (au format ANSI ou Unicode).
fLitLigneExpressionRégulièreLit une ligne d'un fichier externe et récupère dans des variables les morceaux de cette ligne en fonction d'une expression régulière.
fNomCourtRenvoie le nom court d'un fichier ou d'un répertoire.
fNomFichierRenvoie le nom d'un fichier externe actuellement ouvert.
fNomLongRenvoie le nom long d'un fichier ou d'un répertoire.
fOuvreOuvre un fichier externe (ANSI ou UNICODE) pour le manipuler par programmation.
fOuvreFichierTempCrée et ouvre un fichier temporaire.
fPositionneRenvoie et modifie la position en cours dans un fichier externe.
fRegroupeRegroupe plusieurs fichiers en un seul fichier.
fRelativiseRenvoie le chemin relatif d'un fichier par rapport à un répertoire de référence.
fRenommeModifie le nom d'un fichier.
fRepRecherche un fichier ou un répertoire.
fRepAttributRenvoie ou modifie les attributs d'un répertoire.
fRepCacheRenvoie le chemin du répertoire à utiliser pour stocker les données en cache de l'application sur l'espace de stockage interne de l'application.
fRepCopieCopie le contenu d'un répertoire et éventuellement ses sous-répertoires.
fRepCréeCrée un répertoire (et les répertoires intermédiaires si nécessaire).
fRepDéplaceDéplace un répertoire et son contenu.
fRepDonnéesRenvoie le chemin complet du répertoire des fichiers de données HFSQL spécifié par l'utilisateur lors de l'installation de l'application.
fRepDonnéesCommunRenvoie un chemin de répertoire pour les données partagées de l'application courante :
  • entre tous les utilisateurs de la machine
  • entre tous les utilisateurs TSE
Ce répertoire est utilisable sans restriction sous Windows XP, Vista, ... Ce répertoire permet de stocker par exemple : 
  • les fichiers de configuration générale de l'application (fichiers .INI, fichiers .XML, ...).
  • les fichiers de données communs à tous les utilisateurs (fichiers HFSQL .fic, .ndx, .mmo).
fRepDonnéesUtilisateurRenvoie un chemin de répertoire pour les données de l'utilisateur courant de l'application courante.
fRepEnCoursIdentifie ou modifie le répertoire en cours.
fRépertoireExisteTeste l'existence d'un répertoire.
fRépertoireTempRenvoie le nom du répertoire utilisé pour stocker les fichiers temporaires.
fRepEtatsEtRequêtesRenvoie :
  • soit le chemin complet du répertoire des états et requêtes personnels. Ce répertoire correspond au répertoire des états et requêtes visibles uniquement par l'utilisateur qui les a créés.
  • soit le chemin complet du répertoire des états et requêtes partagés. Ce répertoire correspond au répertoire des états et requêtes visibles par tous les utilisateurs de l'application.
fRepExeRenvoie le répertoire à partir duquel l'exécution est lancée.
fRepExisteTeste l'existence d'un répertoire.
fRepGlobalCommunRenvoie un chemin de répertoire pour les données globales de l'application courante (données partagées par plusieurs applications), quel que soit l'utilisateur en cours.
fRepGlobalUtilisateurRenvoie un chemin de répertoire pour les données globales de l'application courante (données partagées par plusieurs applications), pour l'utilisateur en cours.
fRepParentRenvoie le chemin du répertoire parent du répertoire spécifié.
fRepRenommeModifie le nom d'un répertoire.
fRepRessourceRenvoie le chemin des ressources en lecture seule de l'application.
fRepSélecteurOuvre un sélecteur de répertoires.
fRepSupprimeSupprimer un répertoire sur un disque.
fRepTailleRenvoie la taille d'un répertoire en octets.
fRepTempRenvoie le nom du répertoire utilisé pour stocker les fichiers temporaires.
fRepWebRenvoie le nom physique complet du répertoire contenant les images, les fichiers Javascript et Java du site WEBDEV.
fSauveBufferCrée et remplit un fichier texte avec le contenu d'une variable de type chaîne ou buffer.
fSauveTexteCrée et remplit un fichier texte avec le contenu d'un champ texte ou d'une variable texte (variable de type chaîne, champ de saisie d'une fenêtre, un champ Libellé d'un état, ...).
fSélecteurOuvre le sélecteur de fichiers de Windows.
fSélecteurImageOuvre le sélecteur d'images de Windows.
fSepRenvoie le séparateur de répertoire selon la plateforme en cours ('\' ou '/').
fSéparateurRenvoie un chemin de fichier avec des séparateurs normalisés.
fStopCompacteArrête l'opération de compression ou de décompression d'un fichier.
fSupprimeSupprime un fichier accessible depuis le poste en cours.
fSupprimeFichierRépertoireWebSupprime un fichier image du répertoire "_WEB" de l'application (ou de un de ses sous-répertoires).
fSurveilleFichierDéclenche la surveillance d'un fichier.
fSurveilleRépertoireDétecte les modifications effectuées sur le contenu d'un répertoire.
fSurveilleStopArrête toutes les surveillances en cours sur un fichier ou un répertoire.
fSurveilleStopToutArrête toutes les surveillances en cours sur les fichiers et les répertoires.
fTailleRenvoie la taille d'un fichier en octets.
fTailleDécompactéRenvoie la taille d'un fichier avant compression.Lors de la décompression d'un fichier avec fDécompacte, il est conseillé de comparer la taille non-compressée du fichier et l'espace disque disponible.
fTypeMIMERenvoie le type d'un fichier selon la norme MIME (Multipurpose Internet Mail Extensions).
Les fonctions suivantes peuvent également être utilisées pour gérer les fichiers externes :
ComplèteRepAjoute, si nécessaire, le caractère "\" à la fin d'une chaîne de caractères. Cette fonction est utile pour la construction de noms de fichiers complets en cas d'incertitude sur le format du chemin (par exemple si l'utilisateur saisit un chemin de fichier).
DécomplèteRepEnlève le caractère "/" ou "\" à la fin d'une chaîne si ce caractère est présent. Cette fonction est utile pour la construction de noms de fichiers complets en cas d'incertitude sur le format du chemin (par exemple si l'utilisateur saisit un chemin de fichier).
Liste des exemples associés :
La fonction fListeFichier Exemples unitaires (WINDEV) : La fonction fListeFichier
[ + ] Utilisation de la fonction fListeFichier et de sa syntaxe qui renvoie directement la liste des fichiers/répertoires trouvés sous la forme d'une chaine.
Manipulation de fichiers texte Exemples unitaires (WINDEV) : Manipulation de fichiers texte
[ + ] Manipulation des fichiers "texte" avec WINDEV :
- Créer un fichier texte
- Ecrire dans un fichier texte
- Lire dans un fichier texte
Les fonctions TableVers Exemples unitaires (WINDEV) : Les fonctions TableVers
[ + ] Export des données d'une table avec les fonctions WLangage.
Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ l'interfaçage avec Word et Excel
2/ l'envoi de données vers le presse-papiers
3/ la génération d'un fichier texte

Cet exemple montre comment exporter le contenu d'une table vers un document Word, un classeur Excel, le presse-papiers ou vers un fichier texte grâce aux ordres très clairs du WLangage : TableVersWord, TableVersExcel, VersPressePapier, TableVersTexte.
Manipulation de fichiers texte Exemples unitaires (WEBDEV) : Manipulation de fichiers texte
[ + ] Manipulation des fichiers "non HFSQL" avec WEBDEV (création d'un fichier texte, écriture et lecture)
WD Synchronisation de fichiers Exemples complets (WINDEV) : WD Synchronisation de fichiers
[ + ] Cet exemple montre comment synchroniser deux répertoires de fichiers en WLangage. Après synchronisation le répertoire de destination est identique au répertoire source. La comparaison se base sur la présence et la date des fichiers. Ceci peut être très utile pour la gestion des sauvegardes.
Dans cet exemple, nous abordons surtout les fonctions de manipulation de fichiers sur le disque.

Résumé de l'exemple livré avec WINDEV :
Vous sélectionnez un répertoire source contenant les fichiers à sauvegarder, un répertoire de destination où sauvegarder ces fichiers. Vous lancez la synchronisation. L'application va comparer le contenu des deux répertoires. Si le fichier est absent, si le fichier source est plus récent… alors le fichier sera mis à jour dans le répertoire de sauvegarde.
Manipulation de fichiers texte Exemples unitaires (WINDEV Mobile) : Manipulation de fichiers texte
[ + ] Manipulation des fichiers externes de type "texte" :
- Créer un fichier texte
- Ecrire dans un fichier texte
- Lire dans un fichier texte
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale