Function Entry: TBLSEARCH
← Prev | ↑ Chapter | Next → | Index | Symbols
Function Entry: TBLSEARCH
Name
tblsearch
Class
Host Function
Syntax
(tblsearch table-name symbol [setnext])
Arguments and Values
table-name: symbol table designatorsymbol: entry namesetnext: optional iteration-control flag
Autodesk documents both table-name and symbol as strings and case-insensitive.
Description
Searches a symbol table for a named entry.
Return Values
Association list for the matching entry, or nil.
Side Effects
May affect table-iteration state when the optional flag is used.
Compatibility
Part of the core CAD database querying model.
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
Notes
- If
setnextis supplied and non-nil, Autodesk documents that the nexttblnextcall returns the entry following the one found bytblsearch.
clautolisp
clautolisp seeds the full standard symbol-table set and answers
tblsearch / tblnext / tblobjname over all of them:
LAYER, LTYPE (a.k.a. LINETYPE), STYLE (a.k.a. TEXTSTYLE),
BLOCK (the block-record table), VIEW, UCS, VPORT, DIMSTYLE,
and APPID (also grown by regapp). The string values in a returned
table record are AutoLISP strings (so strcat, = and type accept
them directly, as on a real CAD). tblnext order is deterministic
(name-sorted) but not contractually the vendor's order; assert
membership, not iteration order. AutoLISP cannot create symbol-table
records with entmake in clautolisp yet (a table record created that
way is stored as an ordinary object, not a table row) — use regapp
for APPID; other tables are pre-seeded. This create-gap is tracked as a
deferred item.