Function Entry: VL-FILE-RENAME

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: VL-FILE-RENAME

Name

vl-file-rename

Class

Visual LISP File Function

Syntax

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

Arguments and Values

old-filename: existing pathname string
new-filename: new pathname string

Description

Renames a file.

Return Values

T or nil.

Side Effects

Renames or moves the designated file under host file-system semantics.

Exceptional Situations

Errors are reported for missing files, conflicting destinations, or invalid pathnames.

Availability

AutoCAD 2026: documented (per Autodesk reference page).
BricsCAD V26: presumed compatible (no contradicting page found).
Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Source Notes

[vl-file-rename (AutoLISP)](https://help.autodesk.com/cloudhelp/2026/PLK/AutoCAD-LT-AutoLISP-Reference/files/GUID-188B957C-4CDF-41C7-99BE-8080FA587F74.htm)

Notes

Autodesk documents that the function fails if the target file already exists.
Autodesk documents a Unicode/LISPSYS behavior change in AutoCAD 2021.