DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
  • Espace
  • Modification du disque et du répertoire en cours
  • Répertoire en cours lors de tests
  • Serveur SOAP
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
Identifie ou modifie le répertoire en cours.
// Connaître le répertoire en cours
ResRepEnCours = fRepEnCours()
Syntaxe

Connaître le répertoire en cours sur le disque spécifié Masquer les détails

<Résultat> = fRepEnCours([<Disque> [, <Option>]])
<Résultat> : Chaîne de caractères
  • Chemin du répertoire en cours sur le disque spécifié (260 caractères maximum). Ce chemin se termine par le caractère "\" uniquement à la racine d'un disque ("A:\" par exemple).
    AndroidWidget Android Ce répertoire correspond au répertoire utilisé pour le stockage des fichiers privés de l'application dans la zone de stockage interne (répertoire "files"). Il est possible de lire et d'écrire dans ce répertoire.
    iPhone/iPadWidget IOSMac Catalyst Ce répertoire correspond au répertoire "Documents" de l'application. Il est possible de lire et d'écrire dans ce répertoire. Les fichiers présents dans ce répertoire peuvent être accessibles par iTunes.
    Universal Windows 10 App Par défaut (si le paramètre <Disque> n'est pas spécifié), ce répertoire correspond au répertoire d'installation de l'application. Il n'est pas possible de lire ou d'écrire dans ce répertoire.
  • -1 en cas d'erreur. Pour connaître le libellé de cette erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Disque> : Chaîne de caractères optionnelle
Nom du disque sur lequel le répertoire en cours est recherché. Ce nom est sous la forme :
  • <lettre du lecteur>:. Par exemple : "A:".
  • chemin UNC. Par exemple : "\\<NomServeur>\<NomPartage>".
Si ce paramètre n'est pas précisé, le disque correspond au disque en cours.
AndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystJavaPHP Ce paramètre n'est pas disponible.
<Option> : Constante optionnelle de type Entier
Permet de spécifier le format du résultat de la fonction. Par défaut, la fonction fRepEnCours renvoie une chaîne de caractères Ansi.
fCheminUnicode<Résultat> sera une chaîne de caractères au format Unicode.

AndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystJavaPHP Ce paramètre n'est pas disponible.

Modifier le répertoire en cours Masquer les détails

<Résultat> = fRepEnCours(<Chemin du nouveau répertoire en cours> [, <Option>])
<Résultat> : Chaîne de caractères
  • Chemin du répertoire en cours (260 caractères maximum). Ce chemin se termine par le caractère "\" uniquement à la racine d'un disque ("A:\" par exemple).
  • -1 en cas d'erreur. Pour connaître le libellé de cette erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Chemin du nouveau répertoire en cours> : Chaîne de caractères
Chemin complet (ou relatif) du nouveau répertoire en cours (260 caractères maximum). Un chemin de type UNC peut être utilisé : il doit être de la forme "\\<NomServeur>\<NomPartage>\<NomRépertoire>".
WindowsLinux Ce paramètre peut être au format Ansi ou Unicode.
<Option> : Constante optionnelle de type Entier
Permet de spécifier le format du résultat de la fonction. Par défaut, la fonction fRepEnCours renvoie une chaîne de caractères Ansi.
fCheminUnicode<Résultat> sera une chaîne de caractères au format Unicode.

AndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystJavaPHP Ce paramètre n'est pas disponible.
Remarques

Espace

Les espaces à droite de la chaîne <Chemin du nouveau répertoire en cours> sont automatiquement supprimés par la fonction fRepEnCours :
fRepEnCours("C:\MonRépertoire\    ")
est équivalent à :
fRepEnCours("C:\MonRépertoire")

Modification du disque et du répertoire en cours

Si un changement de disque doit être effectué, il est conseillé d'utiliser :
  1. La fonction fDisqueEnCours pour modifier le disque en cours,
  2. La fonction fRepEnCours pour modifier le répertoire en cours sur le nouveau disque.
Si le disque demandé avec la fonction fRepEnCours ne correspond pas au disque en cours, le changement de disque est automatiquement réalisé.

Répertoire en cours lors de tests

Lors de tests depuis l'éditeur WINDEV (GO de fenêtre ou de projet), le répertoire en cours correspond :
  • au répertoire de génération de la configuration de projet courante,
  • ou à défaut au sous-répertoire EXE de votre projet.
PHP Lors du GO d'un projet PHP, le répertoire courant est le répertoire "<NomProjet>_WEB".
WINDEVEtats et RequêtesCode Utilisateur (MCU)

Serveur SOAP

La fonction fRepEnCours utilisée sur un serveur SOAP retourne le répertoire en cours du serveur Internet utilisé. Il est interdit de modifier ce répertoire.
Liste des exemples associés :
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
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)
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
Composante : wd300std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
IOS : le chemin change à chaque build
Attention lors de vos développements sur iOS.

Si vous avez besoin d'enregistrer le chemin vers un fichier ou un dossier créer dans le répertoire de l'application il faut utiliser les chemins relatifs.

Le résultat de la fonction fRepEnCours() change à chaque build de l'application.

/Users/Utilisateur/library/Developer/coreSimulation/Devices/XXX-XXX../data/Containers/Data/Application/$Chagement_ici/Documents/

Donc je vous recommande :
sMonChemin est une chaine = fRepEnCours()+sCheminRelatifSav
Nicolas COMPAIN
08 déc. 2018

Dernière modification : 20/08/2024

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