vl-file-rename (AutoLISP)

Benennt eine Datei um.

Unterstützte Plattformen: Windows und macOS

Signatur

(vl-file-rename old-filename new-filename)

old-filename

Typ: Zeichenfolge

Name der Datei, die Sie umbenennen möchten. Wenn Sie keinen vollständigen Pfadnamen angeben, sucht vl-file-rename im AutoCAD-Vorgabeverzeichnis für Zeichnungen.

new-filename

Typ: Zeichenfolge

Neuer Name, der der Datei zugewiesen werden soll.

Anmerkung: Wenn Sie keinen Pfadnamen angeben, schreibt vl-file-rename die umbenannte Datei in das AutoCAD-Vorgabeverzeichnis für Zeichnungen.

Rückgabewerte

Typ: T oder Null

T, wenn die Umbenennung erfolgreich abgeschlossen wurde; Null, wenn die Umbenennung fehlschlägt.

Anmerkung: Wenn die Zieldatei bereits vorhanden ist, schlägt diese Funktion fehl.

Versionsinformationen

Versionen:

• AutoCAD R14 and later on Windows
• AutoCAD 2011 and later on Mac OS

Verlauf

AutoCAD 2021

• Für die Argumente old-filename und new-filename wurden zuvor ASCII-Zeichenfolgen akzeptiert, nun werden aber Unicode-Textzeichenfolgen akzeptiert.
• Die Systemvariable LISPSYS steuert, welche AutoLISP-Engine verwendet wird und wie sich die Funktion verhält.
  • 0 – ASCII-Zeichenunterstützung (altes Verhalten)
  • 1 oder 2 – Unicode-Zeichenunterstützung
  Anmerkung: Nachdem der Wert der Systemvariablen LISPSYS geändert wurde, muss AutoCAD neu gestartet werden, damit die Änderung wirksam wird.

Beispiele

Windows

(vl-file-rename "c:/newauto.bat" "c:/myauto.bat")
T

Mac OS

(vl-file-rename "/oldstartup.sh" "/mystartup.sh")
T