TclSetRecursionLimit(3) Tcl Library Procedures TclSetRecursionLimit(3)

NAME
       TclSetRecursionLimit  -  set maximum allowable nesting depth in inter-
       preter

SYNOPSIS
       ##iinncclluuddee <>

       int
       TTccllSSeettRReeccuurrssiioonnLLiimmiitt(interp, depth)

AARRGGUUMMEENNTTSS
       TclInterp   *interp   (in)      Interpreter whose recursion  limit  is
                                        to be set.  Must be greater than zero.

       int          depth     (in)      New limit for nested calls to TTccllEEvvaall
                                        for interp.



DESCRIPTION
       At any given time Tcl enforces a limit on the number of recursive calls
       that may  be  active  for  TTccllEEvvaall  and  related  procedures  such  as
       TTccllGGlloobbaallEEvvaall.   Any  call  to  TTccllEEvvaall  that  exceeds  this depth is
       aborted with an error.  By default the recursion limit is 1000.

       TTccllSSeettRReeccuurrssiioonnLLiimmiitt may be used to change the maximum allowable nest-
       ing depth for an interpreter.  The depth argument specifies a new limit
       for interp, and TTccllSSeettRReeccuurrssiioonnLLiimmiitt returns the old limit.   To  read
       out  the  old  limit without modifying it, invoke TTccllSSeettRReeccuurrssiioonnLLiimmiitt
       with depth equal to 0.

       The TTccllSSeettRReeccuurrssiioonnLLiimmiitt only sets the size of the Tcl call stack:  it
       cannot  by  itself prevent stack overflows on the C stack being used by
       the application.  If your machine has a limit on  the  size  of  the  C
       stack,  you  may  get  stack overflows before reaching the limit set by
       TTccllSSeettRReeccuurrssiioonnLLiimmiitt.  If this happens, see if there is a mechanism in
       your system for increasing the maximum size of the C stack.


KKEEYYWWOORRDDSS
       nesting depth, recursion



Tcl                                   7.0             TclSetRecursionLimit(3)