LispWorks User Guide and Reference Manual > 27 The COMMON-LISP Package

NextPrevUpTopContentsIndex

untrace

Macro
Summary

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

Package

common-lisp

Signature

untrace { function-name | method-desc }* => untrace-list

Arguments

function-name

A symbol whose symbol-function is no longer to be traced.

method-desc

Is a method description, as described in the entry for trace. See trace for more details.

Values

When called with no arguments, it returns the symbols of all functions currently being traced. When called with one or more functions as arguments, untrace returns a list of the symbols of those functions. Thus, in all situations, untrace returns a list of the symbols of those functions being untraced.

Description

untrace is used to cease the tracing of functions. 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 symbols then the tracing of those functions is stopped. A warning is given if untrace is called with a function that is not being traced.

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)))
See also

trace
untrace-new-instances-on-access
untrace-on-access


LispWorks User Guide and Reference Manual - 22 Dec 2009

NextPrevUpTopContentsIndex