Function Entry: VL-REGISTRY-WRITE

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

Function Entry: VL-REGISTRY-WRITE

Name

vl-registry-write

Class

Visual LISP Function

Syntax

(vl-registry-write reg-key [val-name val-data])

Arguments and Values

  • reg-key: string; the key path. May not start with `HKEYUSERS or HKEYLOCALMACHINE`.
  • val-name (optional): string; the value name. With no val-name, the default value is written.
  • val-data (optional): string; the data. With val-name but no val-data, an empty string is written.

Description

Creates a key, or sets a named value within a key, in the Windows registry, or the equivalent in a macOS property-list file.

Return Values

The stored data string on success; nil on failure.

Side Effects

Mutates the user-level persistent settings store.

Examples

  • (vl-registry-write "HKEY_CURRENT_USER\Test" "" "test data") returns "test data".

Availability

  • AutoCAD 2026: documented (Windows + macOS).
  • BricsCAD V26: presumed compatible.
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Source Notes