C++
struct resbuf * acdbDictSearch( const ads_name dict, const ACHAR* sym, int setnext );
File
acedads.h
Description
Scans the specified dictionary for an entry and returns it as a result-buffer list. This function is similar to acdbTblSearch().
To obtain the entity name of symbol table entry, call acdbTblObjName().
To obtain the master entity name, call acdbNamedObjDict().
Returned DXF Codes
If acdbDictSearch() finds the entry, it returns it as a linked list of result buffers with DXF group codes and values. If it does not find the entry, it returns NULL. It cannot find dictionary entries that have been deleted.
See information on DXF group codes in the AutoCAD Customization Guide for the identification format for dictionary entries returned by these functions.
When acdbDictSearch() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.
Parameters
| Parameters | Description |
|---|---|
| dict | Dictionary to scan, as an entity name |
| sym | Key of the entry to scan for |
| setnext | If nonzero; causes the acdbDictNext( ) function to return the entry that follows the one returned by a successful call toacdbDictSearch( ); otherwise does not affect the order or entries returned by acdbDictNext( ) |