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 designator
  • symbol: entry name
  • setnext: 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.

Notes

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

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.