CLHS: Accessor SYMBOL-PLIST

#

Accessor SYMBOL-PLIST

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)

Side Effects: None.

Affected By: None.

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.

Copyright 1996-2005, LispWorks Ltd. All rights reserved.