acdbTblSearch

C++

struct resbuf * acdbTblSearch(
    const ACHAR * tblname, 
    const ACHAR * sym, 
    int setnext
);

File

acedads.h

Description

Scans the specified symbol table for the specified entry.

To obtain the entity name of the symbol table entry, call the acdbTblObjName() function.

The tblname argument is the name of one of the read-access symbol tables in the current drawing. The valid values for tblname are LAYER, LTYPE, VIEW, STYLE, BLOCK, UCS, DIMSTYLE, VPORT, and APPID.

Returned DXF Codes

If acdbTblSearch() finds sym, it returns the entry as a linked list of result buffers with DXF group codes and values. If it does not find sym, acdbTblSearch() returns NULL. It cannot find table entries that have been deleted.

The identification format for symbol table entries returned by these functions consists of a group with a 0 code that contains the name of the table and a group with a 2 code that contains the table entry name. These types of objects exist in only one container in the drawing, so the codes are interchangeable with the entry's entity name.

The acdbTblSearch() function returns information consistent with AutoCAD Release 12 identification format. It does not return the complete symbol table entry, expanded in Release 13 to include the object name, xdata, and persistent reactors attached to the symbol table.

Next Entry

Normally, acdbTblSearch() has no effect on the order of entries retrieved by acdbTblNext().

The setnext option is the most useful when dealing with the VPORT symbol table, because all viewports in a particular configuration have the same name (for example, *ACTIVE).

If the VPORT symbol table is accessed when TILEMODE is off, any changes have no visible effect until TILEMODE is on. (TILEMODE is set either by using the SETVAR command or by entering its name directly.) Do not confuse vports described by the VPORT symbol table with paper-space viewport entities.

When acdbTblSearch() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Parameters