| |
ANSI Common Lisp  25 Environment 25.2 Dictionary of Environment
| 25.2.8 trace, untrace |
Macro |
- Syntax:
-
trace
{function-name}*
 trace-result
untrace
{function-name}*
untrace-result
- Arguments and Values:
-
function-name - a function name.
trace-result - implementation-dependent,
unless no function-names are supplied,
in which case trace-result is a list of function names.
untrace-result - implementation-dependent.
- Description:
-
trace and untrace control the invocation of the trace facility.
Invoking trace with one or more function-names causes
the denoted functions to be "traced."
Whenever a traced function is invoked, information
about the call,
about the arguments passed,
and about any eventually returned values
is printed to trace output.
If trace is used with no function-names,
no tracing action is performed;
instead, a list of the functions currently being traced is returned.
Invoking untrace with one or more function names causes those
functions to be "untraced" (i.e., no longer traced).
If untrace is used with no function-names,
all functions currently being traced are untraced.
If a function to be traced has been open-coded
(e.g., because it was declared inline),
a call to that function might not produce trace output.
- Examples:
-
(defun fact (n) (if (zerop n) 1 (* n (fact (- n 1)))))
FACT
(trace fact)
(FACT)
;; Of course, the format of traced output is implementation-dependent.
(fact 3)
 1 Enter FACT 3
| 2 Enter FACT 2
| 3 Enter FACT 1
| | 4 Enter FACT 0
| | 4 Exit FACT 1
| 3 Exit FACT 1
| 2 Exit FACT 2
1 Exit FACT 6
6
- Side Effects:
-
Might change the definitions of the functions named by function-names.
- Affected By:
-
Whether the functions named are defined or already being traced.
- Exceptional Situations:
-
Tracing an already traced function,
or untracing a function not currently being traced,
should produce no harmful effects, but might signal a warning.
- See Also:
-
*trace-output*,
step
- Notes:
-
trace and untrace may also accept additional
implementation-dependent argument formats. The format of the trace
output is implementation-dependent.
Although trace can be extended to permit non-standard options,
implementations are nevertheless encouraged (but not required)
to warn about the use of syntax or options
that are neither specified by this standard
nor added as an extension by the implementation,
since they could be symptomatic of typographical errors
or of reliance on features supported in implementations
other than the current implementation.
- Allegro CL Implementation Details:
-
None.
|
