Alle Dokumente und Anwendungen auf Ihrem Rechner sind in Dateien auf einer bzw. mehreren Festplatten gespeichert, die auf Ihrem Rechner, Ihr(en) Laufwerk(en) oder anderen Speichermedien angemeldet oder angeschlossen sind. Innerhalb von 4D verwenden wir die Begriffe Datei oder Dokument für diese Dokumente und Anwendungen. In diesem Abschnitt jedoch arbeiten wir überwiegend mit dem Begriff Dokument, da die meisten Befehle für den Zugriff von Dokumenten und weniger für Anwendungen oder Systemdateien eingesetzt werden.

Eine Festplatte kann als eine oder mehrere Partitions formatiert sein, eine Partition heißt Volume. Es spielt keine Rolle, ob auf derselben Festplatte zwei Volumes präsent sind, auf 4D Ebene behandeln Sie diese normalerweise als getrennte und gleiche Einheiten.

Ein Volume kann auf einer Festplatte liegen, die direkt an Ihren Rechner angeschlossen oder über das Netzwerk mit einem File Sharing Protokoll angemeldet ist, wie z.B. TCP/IP, AFP oder SMB auf Macintosh. Wenn Sie Befehle für Systemdokumente auf 4D Ebene einsetzen, behandeln Sie all diese Volumes immer gleich - außer in speziellen Fällen, wenn Sie z.B. mit Plug-Ins die Leistung Ihrer Anwendung in diesem Bereich erweitern.

Jedes Volume hat einen Volume-Namen. Unter Windows werden Volumes mit einem Buchstaben gefolgt von einem Doppelpunkt gekennzeichnet. Mit C: und D: werden im Normalfall Volumes zum Booten Ihres Systems bezeichnet - außer, Sie haben Ihren PC anders konfiguriert. Die Buchstaben E: bis Z: werden für zusätzliche Volumes verwendet, die an Ihrem Rechner angeschlossen oder angemeldet werden (USB Treiber, zusätzliche Treiber, Netzwerk Treiber, usw.). Auf Macintosh haben die Volumes Namen, die Sie auf Ihrem Schreibtisch auf der Finder-Ebene sehen können.

Sie unterteilen Ihre Dokumente im allgemeinen in Ordner, die wiederum Unterordner enthalten können. Sammeln Sie nicht hunderte von Dateien auf derselben Ebene eines Volumes an, denn das ist verwirrend und verlangsamt Ihr System. Unter Windows heißt ein Ordner auch Verzeichnis; auf Macintosh wird schon immer der Begriff Ordner verwendet.

Um ein Dokument eindeutig zu identifizieren, müssen Sie den Namen des Volumes wissen, den Namen des/der Ordner, wo das Dokument liegt und den Dokumentnamen selbst. Diese aneinandergereihten Namen ergeben den Pfadnamen des Dokuments. Die Namen werden durch ein spezielles Zeichen, das Trennungssymbol für Ordner voneinander getrennt. Unter Windows ist es der umgekehrte Schrägstrich (\); auf Macintosh der Doppelpunkt (:), in POSIX syntax  der Schrägstrich (/).

Hierzu ein Beispiel: Sie haben das Dokument Wichtige Notiz.txt im Ordner Notizen, der im Ordner Dokumente liegt, der wiederum im Ordner Aktuelle Projekte liegt.

Unter Windows ergibt sich folgender Pfadname, wenn alles auf dem Laufwerk C: (Volume) liegt:

C:\Aktuelle Projekte\Dokumente\Notizen\Wichtige Notiz.txt

Hinweis: Das Zeichen \ wird auch vom 4D Methodeneditor für Escape Sequenzen (Steuerzeichen) verwendet. Um Probleme bei der Interpretation zu vermeiden, wandelt der Editor Pfadnamen wie C:\Festplatte automatisch um in C:\\Festplatte. Weitere Informationen dazu finden Sie im nachfolgenden Abschnitt Escape Sequenzen und Pfadnamen unter Windows.

Auf Macintosh ergibt sich folgender Pfadname, wenn alles auf der Festplatte (Volume) Interner Treiber liegt:

Interner Treiber:Aktuelle Projekte:Dokumente:Notizen:Wichtige Notiz.txt

Unter Windows hat der Dokumentname die Endung .txt; die Erläuterungen dazu folgen im nächsten Absatz.

Für den kompletten Pfadnamen gilt, unabhängig von der Plattform folgendes Schema:

VolName Trenner { OrdnerName Trenner { OrdnerName Trenner { ... } } } DokName

Die Dokumente (Dateien) auf den Volumes haben mehrere Merkmale, das sind die Attribute oder Eigenschaften, wie der Dokumentname selbst und seine Endung.

Ein Dokument ist offen im Lese-/Schreibmodus, im Modus Nur-Lesen oder geschlossen. Mit den in 4D integrierten Befehlen kann nur ein Prozess ein Dokument gleichzeitig im Lese-/Schreibmodus öffnen. Ein Prozess kann zwar mehrere Dokumente öffnen und mehrere Prozesse können wiederum mehrere Dokumente öffnen. Sie können dasselbe Dokument beliebig oft im Modus Nur-Lesen öffnen, jedoch nur einmal zur gleichen Zeit im Lese-/Schreibmodus.

Mit den Funktionen Open document, Create document, Append document öffnen Sie ein Dokument. Create document und Append document öffnen die Dokumente automatisch im Lese-/Schreibmodus. Nur mit Open document können Sie den Modus beim Öffnen wählen. Im geöffneten Dokument können Sie Zeichen schreiben sowie aus- und einlesen. Weitere Informationen dazu finden Sie unter den Befehlen RECEIVE PACKET und SEND PACKET. Haben Sie die Bearbeitung abgeschlossen, schließen Sie das Dokument mit dem Befehl CLOSE DOCUMENT.

Der Bezug auf alle offenen Dokumente erfolgt mit dem Ausdruck DocRef, den die Funktionen Open document, Create document und Append document zurückgeben. DocRef erkennt nur ein offenes Dokument. Es ist formell ein Ausdruck vom Typ Zeit. Alle Befehle und Funktionen, die mit offenen Dokumenten arbeiten, erwarten als Parameter DocRef. Übergeben Sie für diese Befehle eine inkorrekte DocRef, tritt ein Fehler im Dateimanager auf.

Hinweis: Wird eine Referenz DocRef von einem preemptive Prozess aufgerufen, ist sie nur von diesem preemptive Prozess verwendbar. Bei Aufruf von einem kooperativen Prozess ist DocRef von jedem anderen kooperativen Prozess verwendbar.

Ein-/Ausgabefehler können auftreten, wenn Sie auf Dokumente zugreifen, also Dokumente öffnen, schließen, löschen, umbenennen bzw. kopieren; wenn Sie die Eigenschaften eines Dokuments ändern; wenn Sie Zeichen in ein Dokument schreiben oder einlesen. Das Dokument wird z.B. nicht gefunden, es ist gesperrt oder bereits im Lese-/Schreibmodus geöffnet. Solche Fehler können Sie über eine Fehlermethode ON ERR CALL abfangen. Die häufigsten Fehler, die beim Verwenden von Systemdokumenten auftreten, werden im Abschnitt OS Systemfehler (-124 -> -33) beschrieben.

Mit den Befehlen Open document, Create document, Append document und Select document können Sie auf die Dokumente über die Standarddialogfenster zum Öffnen oder Sichern zugreifen. 4D gibt dann in der Systemvariable Document den kompletten Pfadnamen des Dokuments zurück. Verwechseln Sie diese Systemvariable nicht mit dem Parameter Document, der in der Parameterliste der Befehle erscheint!

Weitere Informationen dazu finden Sie im Abschnitt Systemvariablen.

Der Methodeneditor von 4D lässt Escape Sequenzen zu. Das ist eine Zeichenfolge, die bestimmte Zeichen ersetzt. Die Sequenz enthält einen linksgerichteten Schrägstrich (\) und ein Zeichen. \t ersetzt z.B. die Eingabe Zeichen Tab für den Tabulator.
Das Zeichen \ wird unter Windows auch als Trenner in Pfadnamen verwendet. In der Regel ersetzt 4D einfache Schrägstriche in Pfadnamen unter Windows durch doppelte Schrägstriche \\, so wird C:\Ordner zu C:\\Ordner.
Schreiben Sie dagegen C:\MeinDokument\Neu, zeigt 4D C:\\MeinDokument\Neu an. In diesem Fall wird der zweite Schrägstrich fälschlicherweise als die Escape Sequenz \N interpretiert. Aus diesem Grund müssen Sie bei Zeichen, die 4D als Escape Sequenz erkennt, stets zwei Schrägstriche eingeben \\.

4D arbeitet mit folgenden Sequenzen:

Die meisten Befehle dieses Abschnitts erlauben Dokumentnamen, relative Pfadnamen oder absolute Pfadnamen:

• Relative Pfadnamen definieren einen Speicherort in Bezug auf den Ordner, wo er auf der Festplatte liegt. Geben Sie nur einen Dokumentnamen an, gilt das als Verwendung eines relativen Pfadnamens. In 4D wird ein relativer Pfadname in der Regel in Bezug auf den Datenbankordner definiert, z.B. dem Ordner mit der Strukturdatei. Relative Pfadnamen sind besonders hilfreich, wenn Anwendungen in heterogenen Umgebungen eingesetzt werden.
• Absolute Pfadnamen definieren einen Speicherort in Bezug auf den Root des Volumes, so dass sie nicht vom aktuellen Speicherort des Datenbankordners abhängen.

Zum Bestimmen, ob ein Pfadname, der in einem Befehl übergeben ist, als absolut oder relativ interpretiert wird, wendet 4D für jede Plattform einen spezifischen Algorithmus an.

Enthält der Parameter nur zwei Zeichen und ist das zweite ein ':',
    oder enthält der Text ':' und '\' als zweites und drittes Zeichen,
    oder ´beginnt der Text mit "\\",
ist der Pfadname absolute.       

In allen anderen Fällen ist der Pfadname relativ.

Beispiele mit dem Befehl CREATE FOLDER:

Startet der Text mit einem Ordnertrenner ':' oder enthält er keinen Trenner, ist der Pfad relativ.

In allen anderen Fällen ist er absolut.

Beispiele mit dem Befehl CREATE FOLDER:

Sie können Inhalt von Pfadnamen mit den Funktionen Path to object und Object to path verwalten. Sie können folgendes aus den Pfadnamen entnehmen:

• Dateinamen
• Pfad des Ordners
• Endung der Datei oder des Ordners