Tcl_BackgroundError man page on UnixWare

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

Tcl_BackgroundError(3)	    Tcl Library Procedures	Tcl_BackgroundError(3)

______________________________________________________________________________

NAME
       Tcl_BackgroundError - report Tcl error that occurred in background pro‐
       cessing

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_BackgroundEr‐
       ror is invoked, interp->result is expected to contain an error message.
       Tcl_BackgroundError  will  invoke the bgerror Tcl command to report the
       error in	 an  application-specific  fashion.   If  no  bgerror  command
       exists,	or  if	it  returns  with  an  error condition, then Tcl_Back‐
       groundError reports the error itself by printing a message on the stan‐
       dard 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_BackgroundError saves the values of  the	errorInfo  and
       errorCode  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 remain‐
       ing error reports for the interpreter are skipped.

KEYWORDS
       background, bgerror, error

Tcl				      7.5		Tcl_BackgroundError(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server UnixWare

List of man pages available for UnixWare

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