Bezeichnung
Rename -- ändert den Namen einer Datei oder eines Verzeichnis (V2.0)
Übersicht
Rename(oldname$, newname$[, t])
Beschreibung
Dieser Befehl benennt eine Datei oder ein Verzeichnis um. oldname$ ist der Name der umzubenennenden Datei oder des Verzeichnisses und kann eine Pfadangabe enthalten. newname$ ist nur der gewünschte neue Name für die Datei/dem Verzeichnis und darf keine Pfadangabe enthalten.

Ab Hollywood 10.0 akzeptiert dieser Befehl ein optionales Tabellenargument t, das die folgenden Tags unterstützt:

Adapter:
Mit diesem Tag können Sie einen oder mehrere Dateisystemadapter angeben, die die Operation ausführen. Dies muss auf eine Zeichenkette gesetzt werden, die den Namen eines oder mehrerer Adapter enthält. Standardmäßig wird der Adapter verwendet, der mit SetDefaultAdapter() gesetzt wurde. Siehe Lader und Adapter für Details. (V10.0)

UserTags:
Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an den Dateiadapter übergeben werden sollen. Wenn Sie diesen Tag verwenden, müssen Sie ihn 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. (V10.0)

Siehe auch CopyFile(), DeleteFile(), MoveFile() und Exists().

Eingaben
oldname$
Datei oder Verzeichnis, welche/s umbenannt wird
newname$
neuer Name für die Datei/dem Verzeichnis
t
optional: Tabellenargument mit weiteren Optionen (siehe oben) (V10.0)
Beispiel
Rename("image1.png", "image2.png")
Ändert den Namen "image1.png" in "image2.png" um.

Navigation zeigen