Funktionsreferenz

FileCopy

Kopiert eine oder mehrere Dateien.

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

Parameter

source Das Quellverzeichnis der zu kopierenden Datei(en). Wildcards werden unterstützt.
dest Das Zielverzeichnis der zu kopierenden Datei(en).
flag [optional] Dieses Flag bestimmt, ob Dateien überschrieben werden, falls sie schon bestehen.
Kann eine Kombination der folgenden sein:
 0 = (Standard) bestehende Dateien nicht überschreiben
 1 = Überschreiben bestehender Dateien
 8 = Erstellt die Zielverzeichnisstruktur, falls diese nicht besteht (Siehe Anmerkungen).

Rückgabewert

Erfolg: Gibt 1 zurück.
Fehler: Gibt 0 zurück.

Bemerkungen

Das Zielverzeichnis muss bestehen, außer der Flagwert '8' wird genutzt.
Beispiel: Der kombinierte Flagwert '9' (1 + 8) überschreibt das Zielverzeichnis und prüft vorher, ob die Zielverzeichnisstruktur besteht und erstellt sie gegebenenfalls automatisch.

Siehe FileFindFirstFile für Erläuterungen zu Wildcards.

Einige Dateiattribute können ein Überschreiben unmöglich machen.

Verwandte Funktionen

FileMove, FileDelete, DirCopy, DirCreate

Beispiel


FileCopy("C:\*.au3", "D:\mydir\*.*")

; Methode 1 um einen Ordner (samt Inhalt) zu kopieren (ohne ein Flag zu verwenden)
DirCreate("C:\new")
FileCopy("C:\old\*.*", "C:\new\")

; Methode 2 um einen Ordner (samt Inhalt) zu kopieren (mit Verwendung des Flags 8 um das Zielverzeichnis mit zu erstellen)
FileCopy("C:\old\*.*", "C:\new\", 8)

FileCopy("C:\Temp\*.txt", "C:\Temp\TxtFiles\", 8)
; Korrekt - 'TxtFiles' ist nun das Zielverzeichnis und die Dateinamen werden durch die Quellnamen festgelegt

FileCopy("C:\Temp\*.txt", "C:\Temp\TxtFiles\", 9) ; Flag = 1 + 8 (überschreiben + Zielverzeichnisstruktur erstellen)
; Kopiert die .txt-Dateien von der Quelle in das Ziel und überschreibt Dateien im Ziel mit dem gleichen Dateinamen