Function Entry: VL-EXIT-WITH-ERROR

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

Function Entry: VL-EXIT-WITH-ERROR

Name

vl-exit-with-error

Class

Namespace/error-bridge function

Syntax

(vl-exit-with-error msg)

Description

Passes control from a VLX error handler to the *error* function of the calling namespace.

Return Values

Does not return normally to the local caller.

Side Effects

Transfers control across namespace/error boundaries.

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

clautolisp

clautolisp loads no VLX, so every call is outside a separate-namespace VLX. There, measured on AutoCAD 2022 (GUI and accoreconsole) and BricsCAD V25 / V26 (control-flow probe, 2026-10-22/23), vl-exit-with-error is an AutoLISP error WITHOUT a message, whatever msg is: vl-catch-all-apply returns a catch-all error object whose message is nil on AutoCAD and "" on BricsCAD. clautolisp does the same, per dialect (the BricsCAD dialects "", every other dialect AutoCAD's nil), raising the error where vl-exit-with-error is called: *error* (a local one included) is called with an empty message, and without one the error is reported and --on-error applies. (Before 2.3.28 it escaped every handler to the host Lisp's debugger: issue vl-exit-with-error-leaks-host-condition; from 2.3.28 to 2.3.37 the error carried msg: issue vl-exit-outside-vlx-caught-diverges.)