Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

symbol-plist

symbol-plist

type: function (subr) 
location: built-in
source file: xlbfun.c
Common LISP compatible: yes
supported on: all machines

SYNTAX

(symbol-plist <symbol> )
        <symbol>        -       the symbol name with a property list

DESCRIPTION

SYMBOL-PLIST returns the actual property list from the <symbol>. The <symbol> must be an existing, bound variable, but it does not need to have anything in it's property list.

Property lists are lists attached to any user defined variables. The lists are in the form of (name1 val1 name2 val2 ....). Any number of properties may be attached to a single variable.

EXAMPLES

(setq person 'bobby)                    ; create a var with a value
(putprop person 'boogie 'last-name)     ; add a LAST-NAME property
(putprop person 'disc-jockey 'job)      ; add a JOB property
(putprop person '(10 20 30) 'stats)     ; add a STATS list
(symbol-plist person)                   ; returns the property list:
                                        ; (STATS (10 20 30)
                                        ;  JOB DISC-JOCKEY
                                        ;  LAST-NAME BOOGIE)


Go to the first, previous, next, last section, table of contents.