Structure file

Home

4D v20 R7

Structure file


Structure file {( * )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
*	Operator	Gibt die Strukturdatei der Host Datenbank zurück
Funktionsergebnis	String	Kompletter Name der Strukturdatei der Datenbank

Beschreibung

Die Funktion Structure file gibt den kompletten Namen der Strukturdatei der Datenbank zurück, mit der Sie gerade arbeiten.

Mit binären Anwendungen gibt der Befehl den Pfadnamen der Datei .4db zurück.
Mit Anwendungen im Projektmodus gibt der Befehl den Pfadnamen der Datei .4dproject zurück.

Hinweis: Im Fall einer Anwendung mit einkompilierter 4D Volume Desktop gibt die Funktion den Pfadnamen der Anwendungsdatei (ausführbare Anwendung) unter Windows und macOS zurück. Auf macOS liegt sie innerhalb des Software-Pakets im Ordner [Contents:Mac OS]. Das stammt aus einer früheren Vorgehensweise und wird zur Wahrung der Kompatibilität beibehalten. Um den vollständigen Namen des Software Pakets zu erhalten, verwenden Sie besser die Funktion Application file. Prüfen Sie die Anwendung zuerst mit der Funktion Application type, dann führen Sie je nach Kontext die Funktion Structure file oder Application file aus.

WARNUNG: Rufen Sie diese Funktion mit 4D im remote Modus auf, gibt sie nur den Namen der Struktur-/Projektdatei zurück und nicht den kompletten Pfadnamen.

Wird die Funktion von einer Komponente aus aufgerufen, gilt folgendes:

Ist der Parameter * übergeben, gibt die Funktion den langen Namen der Strukturdatei der Host Datenbank zurück.
Ist der Parameter * nicht übergeben, gibt die Funktion den langen Namen der Strukturdatei der Komponente zurück. Die Strukturdatei einer Komponente entspricht der Datei .4db oder .4dc der Komponente, die im Ordner Components der Datenbank liegt. Eine Komponente lässt sich auch in Form eines Alias/Tastenkürzel oder eines .4dbase Ordners/Package installieren:

Bei einem Alias/Tastenkürzel gibt die Funktion den Pfadnamen der Originaldatei .4db oder .4dc zurück (Das Alias bzw. Tastenkürzel wird aufgelöst).
Bei einem .4dbase Ordner/Package gibt die Funktion den Pfadnamen der Datei .4db oder .4dc innerhalb dieses Ordners/Package zurück.

Wird die Funktion über eine Methode der Host Datenbank aufgerufen, gibt sie immer den langen Namen der Strukturdatei der Host Datenbank zurück, unabhängig ob der Parameter * übergeben ist oder nicht.

Beispiel 1

Dieses Beispiel zeigt Name und Position der gerade verwendeten Strukturdatei an:

 C_OBJECT($fullpath)

 C_TEXT($name;$path)

 If(Application type#4D Remote mode)

    $fullpath:=Path to object(Structure file)

    $name:=$fullpath.name

    $path:=$fullpath.parentFolder

    ALERT("You are currently using the database "+Char(34)+$name+Char(34)+" located at "+Char(34)+$path+Char(34)+".")

 Else

    ALERT("You are connected to the database "+Char(34)+Structure file+Char(34))

 End if

Beispiel 2

Folgendes Beispiel fragt ab, ob die Methode über eine Komponente aufgerufen wird:

 C_BOOLEAN($0)

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

  ` $0=True wenn die Methode über eine Komponente aufgerufen wird

Siehe auch

_o_DATA SEGMENT LIST
Application file
COMPONENT LIST
Data file