dictremove
(dictremove dictionary item)
The dictremove function removes an entry from the specified dictionary.
By default, removing an entry from a dictionary does not delete it from the database. This must be done with a call to entdel. The exceptions to this rule are GROUPs and MLINESTYLEs. The code that implements these features requires that the database and these dictionaries be up to date and, therefore, automatically deletes the entity when it is removed (with dictremove) from the dictionary.
Arguments
dictionary specifies a dictionary entity name.
item specifies the name of an item in the dictionary to be removed.
Return Value
The return value is the name of the removed object. If the dictionary argument is invalid or the item argument is not found, the function returns nil.
Note: The dictremove function does not allow the removal of a RichtLineStyle from the MLINESTYLE dictionary if it is actively referenced by a RichLine in the database.
The following example removes the dictionary created in the dictadd example:
: (dictremove (namedobjdict) "my_personal_dictionary")
<Entity name: 1d98950>
dictadd, dictnext, dictrename, dictsearch, namedobjdict