with-profiling

Macro

Package: prof

ToC

DocOverview

CGDoc

RelNotes

FAQ

Index

PermutedIndex

Allegro CL version 9.0
Unrevised from 8.2 to 9.0.
8.2 version

with-profiling

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

This macro collects runtime analyzer data for the execution of body by starting data collection, executing body, and then stopping data collection. 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. See also stop-profiler.

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

This macro returns the value returned by the body.

See runtime-analyzer.htm for general information on the runtime analyzer.