This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

Tcl_AllowExceptions(3)                     Tcl Library Procedures                     Tcl_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_Eval-Objv, Tcl_EvalObjv,
       Objv, 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                                                  7.4                              Tcl_AllowExceptions(3)