Function Entry: VLAX-MAKE-SAFEARRAY

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

Function Entry: VLAX-MAKE-SAFEARRAY

Name

vlax-make-safearray

Class

Visual LISP automation utility

Syntax

(vlax-make-safearray type bounds)

Arguments and Values

  • type — integer constant naming the element type.
  • bounds — one or more dotted pairs (l-bound . u-bound) defining dimensions.

Autodesk documents the element-type constants:

  • vlax-vbInteger
  • vlax-vbLong
  • vlax-vbSingle
  • vlax-vbDouble
  • vlax-vbString
  • vlax-vbObject
  • vlax-vbBoolean
  • vlax-vbVariant

Description

Creates a safearray.

Return Values

Safearray object.

Side Effects

Allocates automation-array storage.

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.

Notes

  • Autodesk documents a maximum of 16 dimensions.

Compatibility

Available only on Windows; not available on macOS or Web.

clautolisp

clautolisp implementation note — not part of the normative specification above. (vl-load-com) binds the vlax-vb* type constants with the ActiveX enumeration constants (once per document, never over a non-nil value; from the start of the document under the BricsCAD dialects) to the values MEASURED by probes/sources/probe-activex-constants.lsp on AutoCAD 2022, BricsCAD V25 and BricsCAD V26 (2026-10-23), which are the VB VarType values: vlax-vbEmpty 0, vlax-vbNull 1, vlax-vbInteger 2, vlax-vbLong 3, vlax-vbSingle 4, vlax-vbDouble 5, vlax-vbCurrency 6, vlax-vbDate 7, vlax-vbString 8, vlax-vbObject 9, vlax-vbError 10, vlax-vbBoolean 11, vlax-vbVariant 12, vlax-vbDataObject 13, vlax-vbArray 8192 on both products; vlax-vbDecimal 14 on BricsCAD only (unbound on AutoCAD); vlax-vbByte (documented 17) is bound by neither product and stays unbound in clautolisp (the integer code 17 is still accepted). Per dialect: the AutoCAD dialects bind AutoCAD's set, the BricsCAD dialects BricsCAD's, strict the common subset, clautolisp / lax the union. Implemented in clautolisp/autolisp-builtins-core/source/activex-constants-table.lisp (*ACTIVEX-MEASURED-CONSTANTS*); see issues/open/vlax-vb-constants-unbound.issue.