Manual Pages for UNIX Operating System command usage for man Tcl_AllowExceptions

Tcl Library Procedures                  Tcl_AllowExceptions(3TCL)



_________________________________________________________________

NAME
     Tcl_AllowExceptions - allow all exceptions  in  next  script
     evaluation

SYNOPSIS
     #include 

     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

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:












Tcl                     Last change: 7.4                        1






Tcl Library Procedures                  Tcl_AllowExceptions(3TCL)



     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tcl-8  |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tcl is available on http://opensolaris.org.













































Tcl                     Last change: 7.4                        2