  CLASS
    tcl.lang.Interp -- This manual entry contains Interp methods that report Tcl background errors.
  METHODS
    void backgroundError()
    void addErrorInfo(String message)
    void setErrorCode(TclObject code)
  OTHER METHODS
  ARGUMENTS
  DESCRIPTION
    backgroundError
    addErrorInfo
    setErrorCode
  EQUIVALENT C FUNCTIONS
  SEE ALSO
  KEYWORDS

### CLASS

tcl.lang.Interp -- This manual entry contains Interp methods that report Tcl background errors.

### METHODS

void backgroundError()

void addErrorInfo(String message)

void setErrorCode(TclObject code)

### OTHER METHODS

setVar, traceVar, createCommand, eval, setResult,
getNotifier, setAssocData, dispose, pkgRequire

### ARGUMENTS

String message ()
  Message to appear in global errorInfo Tcl variable.

TclObject code ()
  TclObject to become value of global errorCode Tcl variable.

### DESCRIPTION

The procedures described here are utilities for reporting Tcl errors that occurred in background processing. See the manual entry setResult for information on storing result values.

backgroundError
  The backgroundError method is typically invoked when a Tcl error occurs during "background processing" such as executing an event handler. When backgroundError() is called, it saves the current result, errorCode and errorInfo and will invoke the "bgerror" command at a later time as an idle callback. If no bgerror command exists, or if the bgerror command returns with an error condition, then backgroundError() reports the error itself by printing a message on the standard error output. 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.

addErrorInfo
  The addErrorInfo method appends message to the errorInfo object in the interpreter. The errorInfo object is mirrored in Tcl scripts via the "errorInfo" global variable.

setErrorCode
  The setErrorCode method sets the interpreter's errorCode object to the value of code. The errorCode object is mirrored in Tcl scripts via the "errorCode" global variable.

### EQUIVALENT C FUNCTIONS

Tcl_BackgroundError, Tcl_AddErrorInfo, Tcl_SetObjErrorCode

### SEE ALSO

Interp, TclException, TclRuntimeError, TclEvent, dispose, setAssocData

### KEYWORDS

background, bgerror, error, interpreter

    Copyright © 1994-1998 Sun Microsystems, Inc.
    Copyright © 1995-1997 Roger E. Critchlow Jr.