dictadd


(dictadd  dictEname  keystring  value)

This function adds a new dictionary entry value under key keystring into the dictEname dictionary.

Arguments

dictEname  the entity name (ENAME) of the dictionary

keystring  they key (string) to be used for the new dictionary entry

value  the new value to be added to the dictionary, under keystring key; usually a XRecord ename or another (sub-)dictionary ename

Return

the entity name of the newly added dictionary entry, if successful (NIL otherwise)

Example

(setq subDict (list (cons 0 "DICTIONARY") (cons 100 "AcDbDictionary")))
(setq dictEname (entmakex subDict))
(setq subDict (dictadd (namedobjdict) "MySubDitionary" dictEname))

Remarks

value must be a non-graphical object (i.e. not an entity);
keystring  should be a unique key, "overwriting" an existing entry is not possible;
adding another (sub-)dictionary is also possible



©  Bricsys NV. All rights reserved.