TclBackgroundError(3) Tcl Library Procedures TclBackgroundError(3)

NAME
       TclBackgroundError - report Tcl error that occurred in background pro-
       cessing

SYNOPSIS
       ##iinncclluuddee <>

       TTccllBBaacckkggrroouunnddEErrrroorr(interp)

AARRGGUUMMEENNTTSS
       TclInterp   *interp   (in)      Interpreter   in   which   the   error
                                        occurred.



DESCRIPTION
       This  procedure  is  typically  invoked  when a Tcl error occurs during
       ``background processing'' such as executing  an  event  handler.   When
       such  an  error  occurs, the error condition is reported to Tcl or to a
       widget or some other C code, and there is not usually any  obvious  way
       for that code to report the error to the user.  In these cases the code
       calls TTccllBBaacckkggrroouunnddEErrrroorr  with  an  interp  argument  identifying  the
       interpreter in which the error occurred.  At the time TTccllBBaacckkggrroouunnddEErr-
       rroorr is invoked, the interpreter's result  is  expected  to  contain  an
       error message.  TTccllBBaacckkggrroouunnddEErrrroorr will invoke the bbggeerrrroorr Tcl command
       to report the error in an application-specific fashion.  If no  bbggeerrrroorr
       command  exists,  or  if  it  returns  with  an  error  condition, then
       TTccllBBaacckkggrroouunnddEErrrroorr reports the error itself by printing a  message  on
       the standard error file.

       TTccllBBaacckkggrroouunnddEErrrroorr  does  not  invoke bbggeerrrroorr immediately because this
       could potentially interfere with scripts that are  in  process  at  the
       time  the error occurred.  Instead, it invokes bbggeerrrroorr later as an idle
       callback.  TTccllBBaacckkggrroouunnddEErrrroorr saves the values of  the  eerrrroorrIInnffoo  and
       eerrrroorrCCooddee  variables  and  restores  these  values just before invoking
       bbggeerrrroorr.

       It is possible for many background errors to accumulate before  bbggeerrrroorr
       is  invoked.   When  this  happens,  each of the errors is processed in
       order.  However, if bbggeerrrroorr returns a break exception, then all remain-
       ing error reports for the interpreter are skipped.


KKEEYYWWOORRDDSS
       background, bgerror, error



Tcl                                   7.5               TclBackgroundError(3)