Structure file

4D v15 R3

Structure file


Structure file {( * )} -> Résultat

Paramètre	Type	Description
*	Opérateur	Retourner le fichier de structure de la base hôte
Résultat	Chaîne	Nom long du fichier de structure de la base

Description

La fonction Structure file retourne le nom long (c'est-à-dire le chemin d'accès complet au fichier, y compris son nom) du fichier de structure de la base en cours d'utilisation.

Sous Windows
Si, par exemple, vous travaillez sur la base MesCDs qui se trouve à \DOCS\MesCDs sur le volume G, Structure file renvoie G:\DOCS\MyCDs\MesCDs.4DB.

Sous Macintosh
Si, par exemple, vous travaillez sur la base MesCDs qui se trouve dans le dossier Documents:MesCDsƒ: sur le disque qui s'appelle Macintosh HD, Structure file renvoie Macintosh HD:Documents:MesCDsƒ:MesCDs.

Note : Dans le cas particulier d'une base compilée et fusionnée avec 4D Volume Desktop, cette commande retourne le chemin d'accès du fichier de l'application (fichier exécutable) sous Windows et OS X. Sous OS X, ce fichier est situé à l’intérieur du progiciel, dans le dossier [Contents:MacOS]. Ce fonctionnement provient d’un ancien mécanisme, conservé pour des raisons de compatibilité. Si vous souhaitez obtenir le nom long du progiciel lui-même, il est préférable d’utiliser la commande Application file. L’astuce consiste à tester l’application à l’aide de la commande Application type puis à exécuter Structure file ou Application file en fonction du contexte.

ATTENTION : Si vous appelez cette commande lorsque vous utilisez 4D en mode distant, seul le nom du fichier de structure est renvoyé, pas le nom long.

Le paramètre facultatif * est utile dans le cadre d'une architecture utilisant des composants : il permet de déterminer la structure (hôte ou composant) dont vous souhaitez obtenir le nom long en fonction du contexte d'appel de la commande :

Lorsque la commande est appelée depuis un composant :
- si le paramètre * est passé, la commande retourne le nom long du fichier de structure de la base hôte
- si le paramètre * n’est pas passé, la commande retourne le nom long du fichier de structure du composant.
  Le fichier de structure d’un composant correspond au fichier .4db ou .4dc du composant situé dans le dossier “Components” de la base. Cependant, un composant peut également être installé sous la forme d’un alias/raccourci ou d’un dossier/package .4dbase :
  - dans le cas d’un composant installé sous forme d’alias/raccourci, la commande retourne le chemin d’accès du fichier .4db ou .4dc original (l’alias ou le raccourci est résolu).
  - dans le cas d’un composant installé sous forme de dossier/package .4dbase, la commande retourne le chemin d’accès du fichier .4db ou .4dc à l’intérieur de ce dossier/package.

Lorsque la commande est appelée depuis une méthode d’une base hôte, elle retourne toujours le nom long du fichier de structure de la base hôte, que le paramètre * soit passé ou non.

Exemple 1

Cet exemple affiche le nom et l'emplacement du fichier de structure que vous utilisez :

 If(Application type#4D mode distant)

    $vsStructNomFichier:=Nom long vers nom de fichier(Structure file)

    $vsStructNomChemin:=Nom long vers chemin accès(Structure file)

    ALERT("Vous êtes en train d'utiliser la base "+Char(34)+$vsStructNomFichier+Char(34)+" qui se trouve au "+Char(34)+$vsStructNomChemin+Char(34)+".")

 Else

    ALERT("Vous êtes connecté à la base "+Char(34)+Structure file+Char(34))

 End if

Note : Les méthodes projet Nom long vers nom de fichier et Nom long vers chemin accès sont détaillées dans la section Présentation des documents système.

Exemple 2

L’exemple suivant permet de savoir si la méthode est appelée depuis un composant :

 C_BOOLEAN($0)

 $0:=(Structure file#Structure file(*))

  ` $0=Vrai si la méthode est appelée depuis un composant

Voir aussi

_o_DATA SEGMENT LIST
Application file
COMPONENT LIST
Data file