symbol-plist (ANSI and GNU Common Lisp Document)

Next: symbol-value, Previous: symbol-package, Up: Symbols Dictionary

#### 10.2.13 symbol-plist [Accessor]

`symbol-plist` symbol ⇒ plist

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

#### Arguments and Values::

symbol—a symbol.

plist, new-plist—a 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.