Searches a dictionary for an item
Supported Platforms: Windows and Mac OS
(dictsearch ename symbol [setnext])
Type: ads_name
Name of the dictionary being searched.
Type: String
A string that specifies the item to be searched for within the dictionary.
Type: T or nil
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.
Type: List or nil
The entry for the specified item, if successful; otherwise nil, if no entry is found.
The following example illustrates the use of dictsearch to obtain the dictionary added in the dictadd example:
(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>))