PathCopy()
PathCopy() – Dateipfad kopieren
Die Funktion durchsucht den angegebenen Pfad nach Dateien, die zur Suchmaske aMask passen und kopiert diese nach cDestPath. Unterverzeichnisse von cSourcePath werden ebenfalls durchsucht. Die Namen der Unterverzeichnisse von cSourcePath werden übernommen und fehlende Verzeichnisse ggf. angelegt. Ist die Zieldatei bereits vorhanden, entscheidet der Parameter nCopyMode, was in der jeweiligen Situation geschehen soll.
Hinweis
Die Verarbeitung dieses Befehls kann u.U. sehr lange dauern.
Achtung: cDestPath darf niemals ein Unterverzeichnis von cSourcePath sein.
Parameter | Beschreibung |
---|---|
aMask:U | Suchmaske; kann auch als Array angegeben werden; Platzhalter * bzw. ? sind erlaubt. |
cSourcePath:C | Pfad, in dem die Suche ausgeführt werden soll. Leer startet in aktuellen Verzeichnis. |
cDestPath:C | Pfad, in den die Dateien kopiert werden sollen. Leer kopiert in das aktuelle Verzeichnis. |
nCopyMode:N | Bedeutung von nCopyMode: |
Rückgabewert
Logisch -> True, wenn der Kopiervorgang komplett abgeschlossen wurde, False wenn ein Fehler aufgetreten ist.
Beispiel
// Durchsucht Verzeichnis '\\server\BUILD\' sowie alle darunter liegenden Verzeichnisse
// nach den Dateien 'UPDATE*.RES' und 'DOWN*.RES' und kopiert diese mit Übernahme des
// Teilpfads (unterhalb von '\\server\BUILD\') in das Verzeichnis 'C:\server\BUILD_SAV\'.
// Dateien werden nur überschrieben, wenn die Quelldatei neuer ist als die Zieldatei.
WriteLn(PathCopy({'UPDATE*.RES', 'DOWN*.RES'}, // Suchmaske -> String oder Array
'\\server\BUILD\', // Quell-Verzeichnis
'C:\server\BUILD_SAV\', // Ziel-Verzeichnis
1)) // CopyMode "Nur Neuer"