Function Entry: DICTSEARCH

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

Function Entry: DICTSEARCH

Name

dictsearch

Class

Host Function

Syntax

(dictsearch ename symbol [setnext])

Arguments and Values

  • ename: dictionary entity name
  • symbol: key name
  • setnext: optional iteration-control flag

Autodesk documents symbol as a string.

Description

Searches a dictionary for a named entry.

Return Values

Association list for the matching entry, or nil.

Side Effects

May affect dictionary-iteration state when the optional flag is used.

Compatibility

Part of the drawing-database dictionary API.

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

  • If setnext is supplied and non-nil, Autodesk documents that the next dictnext call returns the entry following the one found by dictsearch.