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 evalu-
				      ated.
________________________________________________________________________________

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  nor-
     mally  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				       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.tcl86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help