tracing-state Accessor

Summary

Gets the current trace details.

Package

dspec

Signature

tracing-state &optional dspec => state

setf (tracing-state &optional dspec) state => state

Arguments

dspec⇩	A dspec.
state⇩	A list.

Values

state⇩

A list.

Description

The accessor tracing-state returns a listing describing the current state of the tracing system. It shows the current tracing state for the dspec dspec, or for all traced definitions if dspec is not supplied.

The result state is a list each element of which is a list whose car is a dspec naming the traced definition and whose cdr is the additional trace options. Note that tracing-state returns more information than is returned by trace. It is useful for preserving a complex set of traces.

The function (setf tracing-state) sets the state of the tracing system. It changes the current tracing state for the dspec dspec, or for all traced definitions if dspec is not supplied.

(setf tracing-state) can be used to switch between different sets of traces. Note however that turning tracing on or off is better done using tracing-enabled-p.

See also

trace
tracing-enabled-p