1Tcl_AllowExceptions(3)      Tcl Library Procedures      Tcl_AllowExceptions(3)
2
3
4
5______________________________________________________________________________
6

NAME

8       Tcl_AllowExceptions - allow all exceptions in next script evaluation
9

SYNOPSIS

11       #include <tcl.h>
12
13       Tcl_AllowExceptions(interp)
14

ARGUMENTS

16       Tcl_Interp   *interp      (in)      Interpreter in which script will be
17                                           evaluated.
18_________________________________________________________________
19
20

DESCRIPTION

22       If a script is evaluated at top-level (i.e. no other scripts are  pend‐
23       ing  evaluation  when  the script is invoked), and if the script termi‐
24       nates  with  a  completion  code  other  than  TCL_OK,   TCL_ERROR   or
25       TCL_RETURN,  then  Tcl  normally  converts this into a TCL_ERROR return
26       with an appropriate message.  The particular script  evaluation  proce‐
27       dures  of  Tcl  that act in the manner are Tcl_EvalObjEx, Tcl_EvalObjv,
28       Tcl_Eval, Tcl_EvalEx,  Tcl_GlobalEval,  Tcl_GlobalEvalObj,  Tcl_VarEval
29       and Tcl_VarEvalVA.
30
31       However,  if  Tcl_AllowExceptions is invoked immediately before calling
32       one of those a procedures, then arbitrary completion codes are  permit‐
33       ted  from the script, and they are returned without modification.  This
34       is useful in cases where the caller can deal with  exceptions  such  as
35       TCL_BREAK or TCL_CONTINUE in a meaningful way.
36
37

KEYWORDS

39       continue, break, exception, interpreter
40
41
42
43Tcl                                   7.4               Tcl_AllowExceptions(3)