Provided by: tcl8.4-doc_8.4.20-7_all bug


       Tcl_AllowExceptions - allow all exceptions in next script evaluation


       #include <tcl.h>



       Tcl_Interp   *interp      (in)      Interpreter in which script will be evaluated.


       If  a  script is evaluated at top-level (i.e. no other scripts are pending evaluation when
       the script is invoked), and if the script terminates with a  completion  code  other  than
       TCL_OK,  TCL_ERROR  or TCL_RETURN, then Tcl normally converts this into a TCL_ERROR return
       with an appropriate message.  The particular script evaluation procedures of Tcl that  act
       in  the  manner  are  Tcl_EvalObjEx,  Tcl_EvalObjv,  Tcl_Eval, Tcl_EvalEx, Tcl_GlobalEval,
       Tcl_GlobalEvalObj, Tcl_VarEval and Tcl_VarEvalVA.

       However, if Tcl_AllowExceptions is invoked immediately  before  calling  one  of  those  a
       procedures,  then  arbitrary  completion codes are permitted from the script, and they are
       returned without modification.  This is useful in cases where the  caller  can  deal  with
       exceptions such as TCL_BREAK or TCL_CONTINUE in a meaningful way.


       continue, break, exception, interpreter