tcl_setrecursionlimit(3tcl) [opensolaris man page]

Tcl_SetRecursionLimit(3TCL)				      Tcl Library Procedures				       Tcl_SetRecursionLimit(3TCL)

__________________________________________________________________________________________________________________________________________________

NAME

       Tcl_SetRecursionLimit - set maximum allowable nesting depth in interpreter

SYNOPSIS

       #include <tcl.h>

       int
       Tcl_SetRecursionLimit(interp, depth)

ARGUMENTS

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

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

DESCRIPTION

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

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

       The Tcl_SetRecursionLimit 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
       Tcl_SetRecursionLimit.  If this happens, see if there is a mechanism in your system for increasing the maximum size of the C stack.

KEYWORDS

       nesting depth, recursion

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTcl	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tcl is available on http://opensolaris.org.

Tcl									7.0					       Tcl_SetRecursionLimit(3TCL)

Tcl_SaveResult(3TCL)					      Tcl Library Procedures					      Tcl_SaveResult(3TCL)

__________________________________________________________________________________________________________________________________________________

NAME

       Tcl_SaveResult, Tcl_RestoreResult, Tcl_DiscardResult - save and restore an interpreter's result

SYNOPSIS

       #include <tcl.h>

       Tcl_SaveResult(interp, statePtr)

       Tcl_RestoreResult(interp, statePtr)

       Tcl_DiscardResult(statePtr)

ARGUMENTS

       Tcl_Interp	 *interp    (in)      Interpreter for which state should be saved.

       Tcl_SavedResult	 *statePtr  (in)      Pointer to location where interpreter result should be saved or restored.
_________________________________________________________________

DESCRIPTION

       These  routines	allows	a  C  procedure  to  take  a snapshot of the current interpreter result so that it can be restored after a call to
       Tcl_Eval or some other routine that modifies the interpreter result.  These routines are passed a pointer to a structure that  is  used	to
       store  enough  information to restore the interpreter result state.  This structure can be allocated on the stack of the calling procedure.
       These routines do not save the state of any error information in the interpreter (e.g. the errorCode or errorInfo variables).

       Tcl_SaveResult moves the string and object results of interp into the location specified by statePtr.  Tcl_SaveResult clears the result for
       interp and leaves the result in its normal empty initialized state.

       Tcl_RestoreResult  moves  the string and object results from statePtr back into interp.	Any result or error that was already in the inter-
       preter will be cleared.	The statePtr is left in an uninitialized state and cannot be used until another call to Tcl_SaveResult.

       Tcl_DiscardResult releases the saved interpreter state stored at statePtr.  The state structure is left in an uninitialized state and  can-
       not be used until another call to Tcl_SaveResult.

       Once  Tcl_SaveResult  is  called  to  save the interpreter result, either Tcl_RestoreResult or Tcl_DiscardResult must be called to properly
       clean up the memory associated with the saved state.

KEYWORDS

       result, state, interp

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTcl	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tcl is available on http://opensolaris.org.

Tcl									8.1						      Tcl_SaveResult(3TCL)