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: 0 - nicht kopieren, wenn Datei im Zielverzeichnis bereits vorhanden ist 1 - nur überschreiben, wenn Datei im Quellverzeichnis neuer ist 2 - immer überschreiben

Rückgabewert

Logisch -> True, wenn der Kopiervorgang komplett abgeschlossen wurde, False wenn ein Fehler aufgetreten ist.

Beispiel

CODE

// 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"

Weitere Verknüpfungen

PathSeek()