Funktionsreferenz

FileMove

Verschiebt eine oder mehrere Dateien.

FileMove ( "source", "dest" [, flag] )

Parameter

source	Der Quellpfad und Dateiname der Datei(en), die verschoben werden soll(en) (* Wildcards werden unterstützt).
dest	Der Zielpfad und Dateiname der verschobenen Datei(en) (* Wildcards werden unterstützt).
flag	[optional] Dieses Flag definiert, ob Dateien überschrieben werden sollen, falls sie bereits existieren: Die folgenden Werte können auch kombiniert werden: 0 = (Standard) Überschreibt bestehende Dateien nicht 1 = Überschreibt bestehende Dateien 8 = Erstellt die Verzeichnisstruktur, falls diese nicht existiert (siehe Bemerkungen).

Rückgabewert

Erfolg:	Gibt 1 zurück.
Fehler:	Gibt 0 zurück, wenn die Quelldatei source nicht verschoben werden kann oder die Zieldatei dest bereits existiert und der Standardwert flag = 0 gesetzt ist.

Bemerkungen

Wenn Quelle und Ziel auf verschiedenen Laufwerken liegen, wird statt des direkten Verschiebens ein Kopier- und anschließender Löschvorgang durchgeführt.

Weil AutoIt keine Funktion "FileRename" besitzt, um Dateien umzubenennen, kann alternativ FileMove verwendet werden!

Das Zielverzeichnis muss bereits bestehen, außer der Parameter "flag" ist auf den Wert "8" gesetzt.
Ist also der kombinierte "flag" auf den Wert "9" (1+8) eingestellt, wird vorab die Zielverzeichnisstruktur auf Vorhandensein überprüft und im negativen Fall automatisch erstellt, danach wird die Zieldatei überschrieben.

Manche Dateiattribute verhindern das Überschreiben einer Datei.

Verwandte Funktionen

FileCopy, FileDelete, FileRecycle, DirMove

Beispiel

FileMove("C:\foo.au3", "D:\mydir\bak.au3")

; Zweites Beispiel:
; benutzt Flags '1' (überschreiben) und '8' (automatisch die Zielverzeichnisstruktur erstellen) zusammen
; verschiebt alle .txt-Dateien vom Temp-Verzeichnis in den Ordner TxtFiles und überprüft, ob
; Zielverzeichnisstruktur bereits existiert, falls nicht wird diese automatisch erstellt
FileMove(@TempDir & "\*.txt", @TempDir & "\TxtFiles\", 9)