Next: , Previous: , Up: Symbols Dictionary  


10.2.6 copy-symbol [Function]

copy-symbol symbol &optional copy-propertiesnew-symbol

Arguments and Values::

symbol—a symbol.

copy-properties—a generalized boolean. The default is false.

new-symbol—a fresh, uninterned symbol.

Description::

copy-symbol returns a fresh, uninterned symbol, the name of which is string= to and possibly the same as the name of the given symbol.

If copy-properties is false, the new-symbol is neither bound nor fbound and has a null property list. If copy-properties is true, then the initial value of new-symbol is the value of symbol, the initial function definition of new-symbol is the functional value of symbol, and the property list of new-symbol is

a copy_2 of the property list of symbol.

Examples::

 (setq fred 'fred-smith) ⇒  FRED-SMITH
 (setf (symbol-value fred) 3) ⇒  3
 (setq fred-clone-1a (copy-symbol fred nil)) ⇒  #:FRED-SMITH
 (setq fred-clone-1b (copy-symbol fred nil)) ⇒  #:FRED-SMIT