Trace

Trace[expr]
generates a list of all expressions used in the evaluation of expr.

Trace[expr,form]
includes only those expressions which match form.

Trace[expr,s]
includes all evaluations which use transformation rules associated with the symbol s.

Details and OptionsDetails and Options

  • In general, form in Trace[expr,form] is compared both with each complete expression that is evaluated, and with the tag associated with any transformation rule used in the evaluation.
  • Trace[expr,lhs->rhs] picks out expressions which match lhs, then replaces them with rhs in the list returned.
  • All expressions in the list returned by Trace are wrapped in HoldForm.
  • Trace returns a set of nested lists. Each individual list corresponds to a single evaluation chain, which contains the sequence of forms found for a particular expression. The list has sublists which give the histories of subsidiary evaluations.
  • The following options can be given:
  • MatchLocalNamesTruewhether to allow x to stand for
    TraceAboveFalsewhether to show evaluation chains which contain the chain containing form
    TraceBackwardFalsewhether to show expressions preceding form in the evaluation chain
    TraceDepthInfinityhow many levels of nested evaluations to include
    TraceForwardFalsewhether to show expressions following form in the evaluation chain
    TraceOffNoneforms within which to switch off tracing
    TraceOn_forms within which to switch on tracing
    TraceOriginalFalsewhether to look at expressions before their heads and arguments are evaluated
  • During the execution of Trace, the settings for the form argument, and for the options TraceOn and TraceOff, can be modified by resetting the values of the global variables , , and , respectively.

ExamplesExamplesopen allclose all

Basic Examples  (1)Basic Examples  (1)

Trace each step in an evaluation:

In[1]:=
Click for copyable input
Out[1]=

Trace only the computations with head Times:

In[2]:=
Click for copyable input
Out[2]=
Introduced in 1991
(2.0)