Function Entry: VL-STRING-SUBST

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

Function Entry: VL-STRING-SUBST

Name

vl-string-subst

Class

Visual LISP Function

Syntax

(vl-string-subst new old string [start-pos])

Arguments and Values

new: replacement string
old: substring to replace
string: source string
start-pos: optional starting position

Description

Replaces the first matching occurrence of old with new in the source string.

Return Values

Modified string.

Side Effects

None.

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-string-subst (AutoLISP)](https://help.autodesk.com/cloudhelp/2023/ENU/AutoCAD-AutoLISP-Reference/files/GUID-D8EE91DC-D4DB-43E0-9AFE-5FA166C0896D.htm)
Status: documented.

Notes

Autodesk documents that the search is case-sensitive.
Autodesk documents that only the first matching occurrence is replaced.
Autodesk documents zero-based indexing for start-pos.
Autodesk documents an AutoCAD 2021 change from ASCII-oriented to Unicode-aware behavior under LISPSYS.