Skip to main content

symbol-plist

symbol-plist Accessor

Syntax:

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.

symbol-value

Expanded Reference: symbol-plist

tip

TODO: Please contribute to this page by adding explanations and examples

(symbol-plist )