Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	 pend-
       ing  evaluation	when  the script is invoked), and if the script	termi-
       nates with a completion code other than TCL_OK,	TCL_ERROR  or  TCL_RE-
       TURN,  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 and Tcl_VarEval.

       However,	if Tcl_AllowExceptions is invoked immediately  before  calling
       one  of those a procedures, then	arbitrary completion codes are permit-
       ted 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tcl_AllowExceptions.tcl90&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help