Function Entry: CLAL-SYSVAR-LIST

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

Function Entry: CLAL-SYSVAR-LIST

Name

clal-sysvar-list

Class

clautolisp Extension Function

Syntax

(clal-sysvar-list)

Arguments and Values

No arguments.

Description

Return the list of sysvar-name strings known to the current host, sorted lexicographically (case-sensitive ASCII order). The names are upper-cased and ready to pass to getvar / setvar.

On a default MockHost the list has 1836 entries – the same universe as the §16 System Variables catalogue. A live AutoCAD or BricsCAD backend would return whatever its engine reports.

Return Values

A proper list of AutoLISP strings. Empty list nil if the host defines no sysvars.

Side Effects

None.

Affected By

  • The selected host backend (NullHost / MockHost / LiveHost).
  • The mock-host catalogue (see §16 System Variables).

Exceptional Situations

Raises :host-not-supported when the active backend has not specialised host-sysvar-names (e.g. the bare NullHost).

Examples

;; Count the sysvars the host knows.
(length (clal-sysvar-list))
=> 1836

;; First few entries.
(mapcar 'identity (cdddr (cdddr (cdddr (clal-sysvar-list)))))
=> ("ACADPREFIX" "ACADVER" ... )

Availability

  • clautolisp: documented (this entry); implemented since clautolisp 1.0.76.
  • AutoCAD: NOT present.
  • BricsCAD: NOT present.

Source Notes

  • clautolisp-only extension; see this chapter's Overview for the rationale and probing convention.