Tcl_AllowExceptions(3tcl)

Tcl_AllowExceptions(3)Tcl Library ProcedureTcl_AllowExceptions(3)

_________________________________________________________________

NAME

     Tcl_AllowExceptions - allow all exceptions  in  next  script
     evaluation

SYNOPSIS

     #include <tcl.h>

     Tcl_AllowExceptions(interp)

ARGUMENTS

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

DESCRIPTION

     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.

KEYWORDS

     continue, break, exception, interpreter

Tcl                     Last change: 7.4                        1