Datei oder Verzeichnis verschieben (file.move)

Deklaration

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

Parameter

• Quellpfad
  Text; absoluter Dateipfad
• Zielpfad
  Text; absoluter Dateipfad
• Modus ab 20250914
  Text; optional, Verschiebemodus. 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

Verschiebt eine Datei oder ein Verzeichnis von Quellpfad nach Zielpfad; eine Änderung des Namens am selben Pfad ist eine Umbenennung.
Schlagwörter: Datei umbenennen, Verzeichnis umbenennen, Ordner umbenennen, Datei verschieben, Verzeichnis verschieben, Ordner verschieben
Erst in Versionen nach 20250313 verfügbar

Beispiel

ok, err = file.move(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.