dictrename

dictremove

D Functions

dictsearch

 

AutoLISP Reference Guide > AutoLISP Functions > D Functions > 

dictrename

Renames a dictionary entry

(dictrename ename oldsym newsym)

Arguments

ename

Name of the dictionary being modified.

oldsym

Original key name of the entry.

newsym

New key name of the entry.

Return Values

The newsym value, if the rename is successful. If the oldname is not present in the dictionary, or if ename or newname is invalid, or if newname is already present in the dictionary, then dictrename returns nil.

Examples

The following example renames the dictionary created in the dictadd sample:

Command: (dictrename (namedobjdict) "my_way_cool_dictionary" "An even cooler dictionary")

"An even cooler dictionary"