"Fossies" - the Fresh Open Source Software archive

Member "jacl1.4.1/docs/TclJavaLib/backgdErr.htm" (8 May 1999, 4842 Bytes) of archive /linux/misc/jacl1.4.1.tar.gz:


Caution: In this restricted "Fossies" environment the current HTML page may not be correctly presentated and may have some non-functional links. Alternatively you can here view or download the uninterpreted source code. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.

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.