5.3 Documentation addenda

with-monitored-definitions

Macro

Syntax:

with-monitored-definitions form
Example:

;;; Assume that the file "example" contains the function
;;; definitions presented in the section "Understanding
;;; Performance Monitoring Output." Loading this file with the
;;;  macro WITH-MONITORED-
;;; DEFINITIONS redefines all of the example functions and
;;; arrangesfor monitoring data to be gathered on the new
;;; definitions. 
> (with-monitored-definitions (load "example")) 
;;; Loading binary file "example.sbin" 
#P"/tmp/example.sbin" 
;;; The function RESET-MONITORS suspends monitoring and clears
;;; any existing monitoring data. 
> (reset-monitors) 
NIL 
> (start-monitoring) 
T 
> (example-function 1000) 
NIL 
> (example-function-2 1000) 
NIL 
> (stop-monitoring) 
NIL 
> (print-monitor 'example-function)
 Monitor information for EXAMPLE-FUNCTION 
Number of calls 	: 1 
Inclusive Time (secs) 	: 0.398
Exclusive Time (secs) 	: 0.398
Inclusive Consing (words) 	: 2004 
Exclusive Consing (words) 	: 2004 
NIL 
> (print-monitor 'example-function-2)
 Monitor information for EXAMPLE-FUNCTION-2 
Number of calls 	: 1 
Inclusive Time (secs) 	: 0.019
Exclusive Time (secs) 	: 0.019
Inclusive Consing (words)  : 2000 
Exclusive Consing (words)  : 2000 
NIL 
> (unmonitor) 
(EXAMPLE-FUNCTION EXAMPLE-TEST-P MAKE-EXAMPLE-LIST EXAMPLE-FUNCTION-2) 

Liquid Common Lisp 5.0 Release and Installation Notes - 9 JUN 1997

Generated with Harlequin WebMaker