*traced-results* Variable

Summary

The list of results from the function being traced.

Package

hcl

Initial Value

nil

Description

Upon leaving a function that is being traced, the variable *traced-results* is bound to the list of results from the function. *traced-results* is then printed after the function name in the output from tracing. It is accessible in the :after forms to trace. However care should be used when manipulating this variable, since it is the value of *traced-results* itself that is used when returning from the traced function. Thus if this value is altered by the :after forms then the caller of the traced function receives the altered results.

Examples

USER 5 > (trace (ceiling
                   :after
                  ((setq *traced-results*
                     (mapcar #'1- *traced-results*)))))

CEILING 
USER 6 > (multiple-value-call #'+ (ceiling 4 3))

0 CEILING > (4 3) 
0 CEILING < (2 -2)  
 (1 -3) 
-2   

Notes

*traced-results* is an extension to Common Lisp.

See also

trace