copy file (from a to b)[,c delete file a]
Gruppe |
Kopiert eine Datei a nach b. Ist Parameter b ein Verzeichnis, wird die Datei a in dieses Verzeichnis kopiert und der Dateiname beibehalten. Wenn Parameter b ein Dateiname ist, wird die Datei a mit dem neuen Dateinamen in das Verzeichnis kopiert. Wenn das Zielverzeichnis noch nicht existiert, wird versucht es zu erzeugen. Falls das nicht möglich ist, wird mit einem Fehler abgebrochen.
Parameter b wird dann als Verzeichnis interpretiert, wenn es ein existierendes Verzeichnis ist, bzw. wenn der Pfadname mit einem Pfad-Trennzeichen endet. Als Pfad-Trennzeichen wird (auch unter Windows) der rechts geneigte Slash / erwartet.
Die Funktion endet mit einem Fehler, wenn Parameter a keine existierende Datei bezeichnet, sowie wenn das Kopieren zum Zielpfad b nicht möglich ist, z. B. weil das Zielverzeichnis nicht erzeugt werden konnte oder wenn der User keine ausreichenden Rechte hat.
Nach erfolgreichem Kopieren der Datei wird der vollständige Pfad der kopierten Datei (Zieldatei) als Ergebnis des Funktionsaufrufs zurück gegeben.
Parameterbeschreibung
Parameter |
Beschreibung |
a |
Quell-Dateiname. |
b |
Ziel-Dateiname/Verzeichnis. |
c |
(optional) true, falls die Quelldatei anschließend gelöscht werden soll. Default: false. |
Beispiele
Parameter a |
Parameter b |
Parameter c |
Ergebnis |
Bemerkung |
./temp/myFile.jpg |
./temp/out |
|
./temp/out/myFile.jpg |
Ziel b wird nur dann als Verzeichnis interpretiert, wenn es ein existierendes Verzeichnis ist, sonst als Dateiname. |
./temp/myFile.jpg |
./temp/out/ |
|
./temp/out/myFile.jpg |
Ziel b wird durch / am Ende als Verzeichnis interpretiert, auch wenn es noch nicht existiert. Dann wird versucht, es zu erzeugen. |
./temp/myFile.jpg |
./temp/out/CopyOfMyFile.jpg |
|
./temp/out/CopyOfMyFile.jpg |
Falls das Zielverzeichnis ./temp/out/ noch nicht existiert, wird versucht, es zu erzeugen. |