Tcl_BackgroundError man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



Tcl_BackgroundError(3)Tcl Library ProcedureTcl_BackgroundError(3)

_________________________________________________________________

NAME
       Tcl_BackgroundError  -  report  Tcl error that occurred in
       background processing

SYNOPSIS
       #include <tcl.h>

       Tcl_BackgroundError(interp)

ARGUMENTS
       Tcl_Interp   *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  Tcl_BackgroundError	 with  an interp argument
       identifying the interpreter in which the	 error	occurred.
       At the time Tcl_BackgroundError is invoked, interp->result
       is  expected  to	 contain  an  error  message.	Tcl_Back-
       groundError  will invoke the bgerror Tcl command to report
       the error in an application-specific fashion.  If no bger-
       ror  command exists, or if it returns with an error condi-
       tion, then Tcl_BackgroundError reports the error itself by
       printing a message on the standard error file.

       Tcl_BackgroundError  does  not  invoke bgerror immediately
       because this could potentially interfere with scripts that
       are  in	process at the time the error occurred.	 Instead,
       it invokes bgerror later as an idle  callback.	Tcl_Back-
       groundError  saves  the values of the errorInfo and error-
       Code variables  and  restores  these  values  just  before
       invoking bgerror.

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

KEYWORDS
       background, bgerror, error

Tcl			       7.5				1

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net