Bezeichnung
CreateDirectory -- Erstellt ein neues Verzeichnis (V11.0)
Übersicht
d$ = CreateDirectory(path$, dir$[, table])
Bibliothek
dos

Beschreibung
Dieser Befehl erstellt das durch dir$ angegebene Verzeichnis im durch path$ angegebenen Pfad. Dies entspricht im Wesentlichen dem Aufruf von MakeDirectory(). Der Unterschied besteht jedoch darin, dass CreateDirectory() kein einzelnes Pfadargument akzeptiert, das sowohl den Pfad als auch die Unterverzeichnisspezifikation enthält, sondern zwei separate Argumente, die das Verzeichnis, in dem das neue Unterverzeichnis erstellt werden soll, und den Namen des zu erstellenden Unterverzeichnisses angeben. Außerdem kann es keine Verzeichnisse rekursiv erstellen, sondern nur ein einzelnes Verzeichnis, und es gibt den Pfad zu dem gerade erstellten Verzeichnis zurück. All dies macht CreateFile() geeignet für die Verwendung mit dem Storage Access Framework (SAF) von Android und mit MediaStore auf Android, die beide etwas anders funktionieren als herkömmliche Pfadangaben. Siehe Arbeiten mit Android-URIs für Details.

Beachten Sie, dass CreateDirectory() im Gegensatz zu MakeDirectory() fehlschlägt, wenn das Verzeichnis bereits existiert.

CreateDirectory() akzeptiert auch ein optionales Tabellenargument, das zur Übergabe zusätzlicher Parameter verwendet werden kann. Derzeit werden die folgenden Tabellenelemente erkannt:

Adapter:
Mit diesem Tag können Sie ein oder mehrere Datei-Adaptermodule angeben, die zum Erstellen des angegebenen Verzeichnisses aufgerufen werden sollen. Dies muss auf eine Zeichenkette gesetzt werden, die den Namen eines oder mehreren Adaptermodulen enthält. Standardmäßig wird das mit SetDefaultAdapter() festgelegte Adaptermodul verwendet. Siehe Lade- und Adaptermodule für Details.

UserTags:
Mit diesem Tag können zusätzliche Daten angegeben werden, die an Datei-Adaptermodule übergeben werden sollen. Wenn Sie dieses Tag verwenden, müssen Sie es auf eine Tabelle mit Schlüssel-Wert-Paaren setzen, die die zusätzlichen Daten enthalten, die an Plugins übergeben werden sollen. Siehe Benutzer-Tags für Details.

Eingaben
path$
Pfad für das neue Verzeichnis
dir$
Name für das neue Verzeichnis
table
Optional: Tabelle mit weiteren Parametern
Rückgabewerte
d$
Pfad zum neu erstellten Verzeichnis
Navigation zeigen