Function Entry: NAMEDOBJDICT

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

Function Entry: NAMEDOBJDICT

Name

namedobjdict

Class

Host Function

Syntax

(namedobjdict)

Description

Returns the entity name of the named object dictionary.

Return Values

An ENAME designating the root named-object dictionary.

Side Effects

None.

Compatibility

This is a key dictionary-entry point into the drawing database.

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.

clautolisp

The named-object-dictionary tree is fully implemented in the in-memory model. namedobjdict lazily creates and then returns a stable ENAME for the root DICTIONARY object; dictadd / dictsearch / dictnext / dictremove / dictrename / dictobjname operate on it and on any sub-dictionary. Dictionaries and their members (typically XRECORDs created with entmakex) are handle-addressed objects, so the member enames feed straight back into entget / entmod / entdel, and dictsearch / dictnext return the same (-1 . ename)-headed entget-style list. A duplicate key makes dictadd return nil; an absent key makes dictsearch return nil — no Common-Lisp condition leaks into AutoLISP. Deviation: because the in-memory model stores these objects in the same table as graphical entities, entnext / entlast can enumerate them, whereas AutoCAD confines dictionary and xrecord objects to the OBJECTS section (out of the entnext walk); ssget already excludes them. This divergence is flagged for verification on a live CAD.