Zum Hauptinhalt springen

Datei oder Verzeichnis kopieren (file.copy)

Deklaration​

erfolg, fehlermeldung = file.copy(Quellpfad, Zielpfad [, Modus])

Parameter​

  • Quellpfad
    Text; absoluter Pfad der Quelldatei oder des Quellverzeichnisses
  • Zielpfad
    Text; vollständiger absoluter Pfad der kopierten Datei oder des kopierten Verzeichnisses einschließlich des Zieldatei- oder Zielverzeichnisnamens
  • Modus ab 20250914
    Text; optional, Kopiermodus. Mögliche Werte:
    • Leere Zeichenkette oder ausgelassen: Standardmodus (no-clobber); bei vorhandenem Ziel wird ein Fehlschlag zurückgegeben
    • "overwrite" oder "o": Überschreibmodus; ersetzt das vorhandene Ziel direkt (das vorhandene Ziel wird gelöscht)
    • "merge" oder "m": Zusammenführungsmodus (nur für Verzeichnisse); vorhandene Dateien im Ziel bleiben erhalten
    • "overwrite-merge" oder "om"/"mo": Überschreibender Zusammenführungsmodus; führt Verzeichnisse zusammen, überschreibt aber gleichnamige Dateien

Rückgabewerte​

  • Erfolg
    Boolescher Wert; bei Erfolg true, bei Fehlschlag false
  • Fehlermeldung
    Text; Fehlermeldung bei einem Fehlschlag

Beschreibung​

Kopiert die Datei oder das Verzeichnis unter Quellpfad als Zielpfad.
Diese Funktion bedeutet „kopieren als“, nicht „hineinkopieren“. Zielpfad bezeichnet die endgültige Datei oder das endgültige Verzeichnis; der Quelldatei- oder Quellverzeichnisname wird nicht automatisch angehängt. Auch wenn das Ziel bereits als Verzeichnis existiert oder der Zielpfad mit / endet, wird die Quelle nicht in dieses Verzeichnis hineinkopiert.
Um beispielsweise /a/b/c unter Beibehaltung des Namens c in /d/e/ zu kopieren, muss der Zielpfad /d/e/c lauten, nicht nur /d/e/.
Existiert das Ziel bereits, entscheidet Modus: Der Standardmodus schlägt fehl, der Überschreibmodus ersetzt das Ziel selbst, und die Zusammenführungsmodi für Verzeichnisse führen den Inhalt des Quellverzeichnisses mit dem Zielverzeichnis zusammen.
Schlagwörter: Datei kopieren, Verzeichnis kopieren, Ordner kopieren
Erst in Versionen nach 20250313 verfügbar

Beispiel​

ok, err = file.copy(XXT_SCRIPTS_PATH..'/1.zip', XXT_SCRIPTS_PATH..'/2.zip')
if not ok then
sys.alert('Kopieren fehlgeschlagen: '..err)
end

Hinweis: Der obige Code verwendet die Funktion sys.alert, die nicht zu diesem Kapitel gehört.

In ein anderes Verzeichnis kopieren und den Namen beibehalten​

-- Angenommen, /d/e ist ein vorhandenes Verzeichnis und /d/e/c existiert noch nicht
file.copy('/a/b/c', '/d/e/c') -- Richtig: c als /d/e/c kopieren

-- Falsche Schreibweise: Das Ziel ist e selbst, nicht c im Verzeichnis e
file.copy('/a/b/c', '/d/e/') -- Schlägt im Standardmodus fehl, da das Ziel bereits existiert

-- Der Überschreibmodus ersetzt e selbst und erzeugt kein /d/e/c (20250914+)
-- file.copy('/a/b/c', '/d/e/', 'overwrite')

Eine Funktion zum Hineinkopieren in ein Verzeichnis definieren​

Das folgende Beispiel definiert eine eigene Hilfsfunktion und erfordert eine Version nach 20250914. Das Zielverzeichnis muss bereits existieren. Die Funktion behält den Namen der Quelldatei oder des Quellverzeichnisses bei und reicht den optionalen Parameter mode an file.copy weiter. Namenskonflikte werden weiterhin gemäß dem angegebenen Modus behandelt.

local function file_copy_into(src_path, dst_dir, mode)
if file.exists(dst_dir) ~= "directory" then
return false, "Target is not a directory"
end

local name, err = file.path.last_component(src_path)
if not name then
return false, err
end
-- Verhindert, dass das Zielverzeichnis selbst oder dessen übergeordnetes Verzeichnis zum endgültigen Ziel wird.
if name == "" or name == "/" or name == "." or name == ".." then
return false, "Source path must end with a file or directory name"
end

local dst_path, path_err = file.path.add_component(dst_dir, name)
if not dst_path then
return false, path_err
end
return file.copy(src_path, dst_path, mode)
end

-- Angenommen, /d/e ist ein vorhandenes Verzeichnis; c als /d/e/c kopieren
local ok, err = file_copy_into("/a/b/c", "/d/e/")
if not ok then
print("Kopieren fehlgeschlagen: "..err)
end

-- Um /d/e/c zu ersetzen, geben Sie beim Aufruf den Überschreibmodus an:
-- file_copy_into("/a/b/c", "/d/e/", "overwrite")

Hinweis: Der obige Code verwendet file.exists, file.path.last_component und file.path.add_component.