dictsearch

dictrename

D Functions

dimx_tile

 

AutoLISP Reference Guide > AutoLISP Functions > D Functions > 

dictsearch

Searches a dictionary for an item

(dictsearch ename symbol [setnext])

Arguments

ename

Name of the dictionary being searched.

symbol

A string that specifies the item to be searched for within the dictionary.

setnext

If present and not nil, the dictnext entry counter is adjusted so the following dictnext call returns the entry after the one returned by this dictsearch call.

Return Values

The entry for the specified item, if successful; otherwise nil, if no entry is found.

Examples

The following example illustrates the use of dictsearch to obtain the dictionary added in the dictadd example:

Command: (setq newdictlist (dictsearch (namedobjdict) "my_way_cool_dictionary"))

((-1 . <Entity name: 1d98950>) (0 . "DICTIONARY") (5 . "52") (102 . "{ACAD_REACTORS") (330 . <Entity name: 1d98860>) (102 . "}") (330 . <Entity name: 1d98860>) (100 . "AcDbDictionary") (280 . 0) (281 . 1) (3 . "DATA_RECORD_1") (350 . <Entity name: 1d98958>))