untrace

untrace Macro

Summary

Turns off the Common Lisp tracing facility on the named functions.

Package

common-lisp

Signature

untrace {untracing-desc}* => untrace-list

untracing-desc ::= function-name | function-dspec

Arguments

`function-name`⇩	A symbol whose symbol-function is to be untraced, or a setf function name. Functions, macros and generic functions may be specified this way.
`function-dspec`⇩	A function-dspec as described in 7.5.1 Function dspecs, which apart from symbols, can specify methods, setf functions and subfunctions.

Values

untrace-list

A list of untracing-descs.

Description

The macro untrace stops the tracing of functions (see 5 The Trace Facility). If it is called with no arguments then the tracing of all currently traced functions is stopped. If it is called with one or more arguments, then the tracing of the functions that are specified by function-name or function-dspec is stopped. A warning is given if untrace is called with a function that is not being traced.

untrace returns the list of untracing-descs that it stopped tracing.

Examples

USER 12 > (progn (untrace) (trace + - / *)) 
*

USER 13 > (+ 2 3) 
0 + > (2 3) 
0 + < (5) 
5

USER 14 > (untrace + -) 
(* |/|)

USER 15 > (+ 2 3) 
5

To untrace a method:

(untrace (clos:method foo (t)))