DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
  • Attention : la fonction fRep conserve un accès sur le répertoire
  • Parcours de répertoires
  • Windows
  • Utilisation de la fonction fRep dans les threads
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
Recherche un fichier ou un répertoire. Cette recherche peut être effectuée à l'aide de caractères jokers (*, ?).
Remarques :
  • Pour tester l'existence d'un fichier, utilisez la fonction fFichierExiste.
  • Pour tester l'existence d'un répertoire, d'un disque ou d'un partage, utilisez la fonction fRépertoireExiste.
  • Pour lister les sous-répertoires d'un répertoire, utilisez la fonction fListeRépertoire.
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaCode Utilisateur (MCU)PHPAjax
// Recherche du fichier "C:\MonRépertoire\MonFichier.doc"
ResRecherche = fRep("C:\MonRépertoire\MonFichier.doc")
 
// Recherche du fichier "C:\MonRépertoire\MonFichier.doc"
ResRecherche = fRep("C:\MonRépertoire\MonFichier.doc", frFichier)
 
// Recherche du répertoire "C:\MonRépertoire\"
ResRecherche = fRep("C:\MonRépertoire\", frRépertoire)
 
// Recherche du premier fichier de type ".doc" dans le répertoire "C:\MonRépertoire"
ResRecherche = fRep("C:\MonRépertoire\*.doc")
Syntaxe
<Résultat> = fRep(<Nom du fichier ou du répertoire recherché> [, <Options>])
<Résultat> : Chaîne de caractères
  • Nom du fichier (avec son extension) ou du répertoire trouvé.
  • Chaîne vide ("") dans le cas contraire. Pour savoir si cette fonction a généré une erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Nom du fichier ou du répertoire recherché> : Chaîne de caractères
Nom et chemin complet (ou relatif) du fichier (ou du répertoire) recherché (260 caractères maximum). Un chemin de type UNC peut être utilisé. Il est possible d'utiliser des caractères jokers (*, ?) dans le nom du fichier.
Si ce paramètre est vide, la fonction poursuit la recherche pour obtenir le nom du prochain fichier (ou répertoire) correspondant : il est ainsi possible d'obtenir la liste des fichiers ou des répertoires appartenant à un répertoire donné.
Si ce paramètre correspond à un nom de répertoire, ce nom peut être terminé indifféremment par "\" ou non.
WindowsLinux Ce paramètre peut être au format Ansi ou Unicode.
AndroidWidget Android Ce paramètre peut correspondre à un chemin complet ou relatif par rapport au répertoire en cours (connu avec la fonction fRepEnCours). Ce paramètre est sensible à la casse.
Rappel : Sous Android, sur l'appareil comme sur l'émulateur, le système de fichiers est en lecture seule. Une application a uniquement le droit d'écrire dans son répertoire d'installation ou dans un de ses sous-répertoires, ainsi que sur la mémoire externe (SDCard).
AndroidWidget AndroidJava Si l'expression "*.*" est utilisée, seuls les fichiers avec extension seront recherchés.
iPhone/iPadWidget IOSMac Catalyst Ce paramètre peut correspondre à un chemin complet ou relatif par rapport au répertoire en cours (connu avec la fonction fRepEnCours). Ce paramètre est sensible à la casse.
Rappel : Sous les iPhone/iPad, une application a uniquement le droit d'écrire dans son répertoire d'installation ou dans un de ses sous-répertoires.
<Options> : Constante ou combinaison de constantes optionnelle de type Entier
Options de recherche :
fCheminUNICODE<Résultat> sera une chaîne de caractères au format Unicode.
Cette constante peut être combinée avec frFichier ou frRépertoire.
frFichier
(Valeur par défaut)
Recherche d'un fichier.
frRépertoireRecherche d'un répertoire.
Remarques

Attention : la fonction fRep conserve un accès sur le répertoire

L'appel à la fonction fRep conserve un accès sur le répertoire, bloquant ainsi sa suppression ou la modification de son nom. Pour débloquer le répertoire, ajoutez la ligne suivante à votre traitement :
fRep("")

Parcours de répertoires

Il ne faut pas imbriquer des parcours de répertoires effectués avec la fonction fRep.
Dans une boucle de parcours de répertoires effectuée avec la fonction fRep, il ne faut pas utiliser la fonction fCopieFichier.

Windows

Sous Windows, un nom de fichier ou de répertoire peut être constitué de minuscules et/ou de majuscules (les noms de fichiers ne sont pas "case sensitive").
Ainsi, il ne faut pas écrire :
SI fRep(NomFichier) = "TOTO" ALORS Info("Fichier trouvé")
Mais, il faut écrire :
SI fRep(NomFichier) ~= "TOTO" ALORS Info("Fichier trouvé")

Utilisation de la fonction fRep dans les threads

Il est déconseillé d'utiliser la fonction fRep au même moment dans deux threads différents.
En effet, le dernier parcours demandé par fRep remplace automatiquement le parcours en cours.
Composante : wd290std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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