with-profiling

$Revision: 5.0.2.3 $

Macro

Package: PROFILER

Arguments: ((&key type except-stack-groups except-processes count count-list verbose start-sampling-p interpret-closures) &body body)

This macro profiles the execution of body by starting the profiler, executing body, and then stopping the profiler. This call to this macro:

(with-profiling (:type :time [other args]) body)

is equivalent to the following code sequence with the exception that the macro returns the result of the body.

(start-profiler :type :time [other args specified to with-profiling])
<body>
(stop-profiler)

The other keyword arguments are the same as the equivalent arguments to start-profiler.

The body argument must be a form or sequence of forms. The system will run the profiler until the last form in body has been evaluated. Then the profiler will stop.

This macro returns the value of body.

See profiling.htm for general information on profiling. Note that the profiler is not available with some Allegro CL products.

The general documentation description is in introduction.htm. The index in index.htm.