12 The LISPWORKS Package

get-inspector-values

Generic Function

Summary

Customizes the information displayed in the Common LispWorks inspector tool.

Package

lispworks

Signature

get-inspector-values object mode

Arguments

object: The object to be inspected.
mode: Name of a mode, ornil.nil defines the default inspection format for object.

Values

Returns five values: names, values, getter, setter and type. names and values are the two lists displayed in columns in the inspector window. getter is ignored. setter is a function used to updated slot values. type is displayed at the foot of the inspector window.

Description

This generic function allows you to customize the Common LispWorks Inspector by adding new formats (corresponding to different values of mode) in which instances of a particular class can be inspected. Modenil is the default mode, which is always present (it can be overwritten).

LispWorks includes methods for:

(get-inspector-values (object nil)) 
(get-inspector-values (standard-object nil)) 
(get-inspector-values (structured-object nil)) 
(get-inspector-values (sequence nil)) 
(get-inspector-values cons nil))

: and so on.
Example
: This example allows inspection of a CLOS object, displaying only direct slots form a chosen class in its class precedence list. This can be useful when an object inherits many slots from superclasses, and the inherited slots are of no interest.

(defmethod lispworks:get-inspector-values 
         ((object standard-object)
          (mode (eql 'direct-as)))
         (declare (ignore mode))
         (loop with object-class =
                (class-of object) 
               with precedence-list = 
                (class-precedence-list object-class)
               with items = 
                (loop for super in precedence-list 
                      collecting (list* 
                                  (format nil "~a" 
                                   (class-name super))
                                   super))
               with class = 
                (or (capi:prompt-with-list items
                        "Direct slots as ...")
                    object-class)
                            ;; default if no selection
               with slots = 
                (class-direct-slots class)
               for slot in slots 
               for name = 
                    (clos::slot-definition-name slot)
               collect name into names
               collect (if (slot-boundp object name)
                           (slot-value object name)
                         :slot-unbound)
               into values
               finally
               (return 
                (values 
                 names
                 values
                 nil
                 #'(lambda 
                    (x slot-name index new-value)
                    (declare (ignore index))
                    (setf (slot-value x slot-name)
                          new-value))
                 (format nil "~a - direct slots as ~a" 
                         (class-name object-class)
                         (class-name class))))))