$RecursionLimit

$RecursionLimit

gives the current limit on the number of levels of recursion that the Wolfram Language can use.

Details

  • $RecursionLimit=n sets the limit on the number of recursion levels that the Wolfram Language can use to be n.
  • $RecursionLimit=Infinity removes any limit on the number of recursion levels.
  • $RecursionLimit gives the maximum length of the stack returned by Stack[].
  • Each time the evaluation of a function requires the nested evaluation of the same or another function, one recursion level is used up.
  • On most computers, each level of recursion uses a certain amount of stack space. $RecursionLimit allows you to control the amount of stack space that the Wolfram Language can use from within the Wolfram Language. On some computer systems, your whole Wolfram Language session may crash if you allow it to use more stack space than the computer system allows.
  • MemoryInUse and related functions do not count stack space.

Examples

open allclose all

Basic Examples  (2)

$RecursionLimit limits infinite recursion with circular definitions:

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

Temporarily reset $RecursionLimit:

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

Scope  (1)

Generalizations & Extensions  (1)

Properties & Relations  (2)

See Also

$IterationLimit  MemoryConstrained  TimeConstrained  MaxRecursion

Tutorials

Introduced in 1988
(1.0)