Datei oder Verzeichnis kopieren (file.copy)

Deklaration

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

Parameter

• Quellpfad
  Text; absoluter Dateipfad
• Zielpfad
  Text; absoluter Dateipfad
• 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 eine Datei oder ein Verzeichnis von Quellpfad nach Zielpfad.
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('拷贝失败：'..err)
end

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