Chemins d'accès

Les fonctions, propriétés et commandes des classes File et Folder vous permettent de manipuler les fichiers et les dossiers comme des objets. Cela rend la gestion des fichiers et dossiers flexible et puissante. Par exemple, pour créer un nouveau fichier dans le dossier Documents de l'utilisateur courant, vous pouvez écrire :

$ok:=Folder(fk documents folder).file("Archives/John4D.prefs").create()

De plus, les objets fichier et dossier prennent en charge les fileSystems, fournissant un chemin contextuel aux principaux dossiers de l'application.

Chemins des filesystem

4D accepte plusieurs chemins de filesystem qui désignent des dossiers 4D spécifiques avec un emplacement variable sur macOS et Windows. Les chemins des filesystem sont utiles pour deux raisons principales :

• Indépendance : Vous pouvez déplacer votre solution d'un emplacement à un autre, indépendamment du système d'exploitation, sans vous préoccuper des chemins,
• Sécurité : Aucun code ne peut accéder aux éléments situés au-dessus de la racine des filesystem sur disque (sandboxing).

Les filesystem suivants sont pris en charge :

filesystem	Désigne
"/DATA"	Dossier data courant
"/LOGS"	Dossier Logs
"/PACKAGE"	Dossier racine du projet (avec ou sans extension 4dbase)
"/PROJECT"	Dossier Project
"/RESOURCES"	Dossier de ressources du projet courant
"/SOURCES"	Dossier des sources du projet courant

Syntaxe POSIX

La syntaxe POSIX est prise en charge sur toutes les plates-formes. La syntaxe POSIX est recommandée car elle est la plus flexible. Elle est utilisée par défaut (retournée par les propriétés file.path et folder.path).

Avec cette syntaxe :

• les dossiers sont séparés par "/"
• les chemins absolus commencent par un "/"
• pour remonter d'un dossier dans un chemin relatif, utilisez "../" devant le nom du chemin (par sécurité, vous ne pouvez pas remonter au-dessus du filesystem).

Dans la syntaxe POSIX, vous utiliserez généralement les chemins filesystem avec les commandes File et Folder, par exemple :

$pathFile:=File("/DATA/Archives/file 2.txt")
$pathFolder:=Folder("/RESOURCES/Pictures")

Syntaxe spécifique à la plate-forme

La syntaxe spécifique à la plate-forme dépend du système d'exploitation sur lequel la commande est exécutée. Notez que lorsque vous créez un objet fichier ou dossier avec cette syntaxe, vous devez le déclarer en utilisant la constante fk platform path comme paramètre.

Windows

Les règles suivantes sont pris en charge :

• les séparateurs de dossiers sont ""
• le texte contient ':' et '' comme deuxième et troisième caractère,
• le texte commence par "".

Exemples avec Folder :

$ok:=Folder("C:\\Monday";fk platform path).create()
$ok:=Folder("\\\\svr-internal\\tempo";fk platform path).create()

Saisie de chemins Windows et séquences d'échappement

The 4D code editor allows the use of escape sequences. Une séquence d’échappement est une suite de caractères permettant de remplacer un caractère “spécial”. La séquence débute par le caractère barre oblique inversée (antislash) \, suivi d’un caractère. Par exemple, \t est la séquence d'échappement pour le caractère Tab.

Le caractère \ est également utilisé comme séparateur dans les noms de chemin sous Windows. En général, 4D interprète correctement les chemins Windows saisis dans l'éditeur de code en remplaçant les barres obliques simples \ par des barres obliques doubles \\`. Par exemple,C:\FolderdeviendraC:\Folder`.

Toutefois, si vous écrivez C:\MyDocuments\New, 4D affichera C:\\MyDocuments\New. Dans ce cas, le deuxième \ est interprété à tort comme \N (une séquence d'échappement existante). Vous devez donc saisir un double \\ lorsque vous souhaitez insérer une barre oblique inversée devant un caractère utilisé dans l'une des séquences d'échappement reconnues par 4D.

Les séquences d'échappement suivantes sont reconnues par 4D :

Séquence d’échappement	Caractère remplacé
\n	LF (Retour ligne)
\t	HT (Tabulation)
\r	CR (Retour chariot)
``\`	``` (Backslash)
\"	" (Guillemets)

macOS

Les règles suivantes s'appliquent (syntaxe HFS+) :

• les séparateurs de dossiers sont ":"
• le chemin ne doit pas commencer par un ":"

Exemples avec Folder :

$ok:=Folder("macintosh hd:";fk platform path).create()
$ok:=Folder("Monday:Tuesday";fk platform path).create() //un volume doit s'appeler Monday

Chemins absolus et relatifs

Constructeurs File et Folder

Les commandes File et Folder n'acceptent que les chemins absolus. Les chemins relatifs ne sont pas pris en charge et provoqueront des erreurs. Par exemple, le code suivant n'est pas autorisé :

    //ERROR
$ko:=Folder("myFolder").create() //nom de chemin relatif avec constructeur

Si vous souhaitez gérer des fichiers ou des dossiers situés à différents endroits (dossier de projet, dossiers système, etc.), vous pouvez utiliser filesystems (voir ci-dessus). Par exemple, vous pouvez écrire :

$okFolder:=Folder("/PACKAGE/myFolder").create() //dossier créé au niveau de la structure
$okFile:=File("/DATA/Prefs/tempo.txt").create() //fichier créé dans le dossier data

.file() et .folder()

Les fonctions des objets dossier telles que folder.file() et folder.folder() attendent des noms de chemin POSIX relatifs. Par exemple :

  //pour référencer un dossier "Picture" dans le dossier des documents de l'utilisateur
$userImages:=Folder(fk documents folder).folder("Pictures")
  //pour créer un dossier sur le bureau
$ok:=Folder(fk desktop folder).folder("myFolder").create()

Les chemins absolus ne sont pas pris en charge et provoqueront des erreurs.

Exemples

La flexibilité des fonctions de fichiers et de dossiers vous offre diverses possibilités de manipulation des fichiers et des dossiers, comme dans les exemples suivants :

$f:=Folder(fk desktop folder).folder("archive/jan2019")

$f2:=Folder("/DATA/archive/jan2019").file("total.txt")

$f3:=Folder("/DATA/archive/jan2019")

$f4:=File("/DATA/info.txt")

$f5:=File("c:\\archives\\local\\jan2019.txt";fk platform path)

$f6:=File(fk backup log file)