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.
Source Notes
- [namedobjdict (AutoLISP)](https://help.autodesk.com/cloudhelp/2026/PLK/AutoCAD-LT-AutoLISP-Reference/files/GUID-A1E43B30-EF8C-452E-97F5-8AC201E310EE.htm)
- Status: documented.
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.