Function Entry: VLAX-SAFEARRAY-PUT-ELEMENT

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

Function Entry: VLAX-SAFEARRAY-PUT-ELEMENT

Name

vlax-safearray-put-element

Class

Visual LISP automation mutator

Syntax

(vlax-safearray-put-element array index value)

Arguments and Values

array — safearray.
index — one integer per dimension selecting the destination element.
value — integer, real, string, VLA-object, safearray, variant, T, or nil.

Description

Adds or stores an element in an array.

Return Values

The value assigned to the element.

Side Effects

Mutates safearray contents.

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

[vlax-safearray-put-element (AutoLISP/ActiveX)](https://help.autodesk.com/cloudhelp/2015/ENU/AutoCAD-AutoLISP/files/GUID-D4D51BF6-E954-4EA8-9A8D-47FE61B860C6.htm)
[About Creating Array Elements (AutoLISP/ActiveX)](https://help.autodesk.com/cloudhelp/2024/JPN/AutoCAD-AutoLISP/files/GUID-04690F92-A1E6-42DC-917B-83D05755D131.htm)

Exceptional Situations

Signals an AutoLISP-visible error if array is not a safearray or the indices are invalid.

Compatibility

Available only on Windows.