CLCS
src report error
Index
symbol-package Symbols Dictionary symbol-value
Accessor

symbol-plist

symbol-plist symbol ⇒ plist

(setf ( symbol-plist symbol) new-plist)

Arguments and Values

symbola symbol.
plist, new-plista property list.

Description

Accesses the property list of symbol.

Examples

 (setq sym (gensym)) ⇒  #:G9723
 (symbol-plist sym) ⇒  ()
 (setf (get sym 'prop1) 'val1) ⇒  VAL1
 (symbol-plist sym) ⇒  (PROP1 VAL1)
 (setf (get sym 'prop2) 'val2) ⇒  VAL2
 (symbol-plist sym) ⇒  (PROP2 VAL2 PROP1 VAL1)
 (setf (symbol-plist sym) (list 'prop3 'val3)) ⇒  (PROP3 VAL3)
 (symbol-plist sym) ⇒  (PROP3 VAL3)

Exceptional Situations

Should signal an error of type type-error if symbol is not a symbol.

See Also

get, remprop

Notes

The use of setf should be avoided, since a symbol’s property list is a global resource that can contain information established and depended upon by unrelated programs in the same Lisp image.

Backlinks

Function Call Forms as Places, get, remprop, Symbol Concepts, symbol, Symbols Dictionary, Symbols in the COMMON-LISP Package