Exceptionclass_main.t[657]

Base class for all exception objects. We derive all exceptions from this base class so that we can write 'catch' blocks that catch all exceptions by catching 'Exception'.

The displayException() method displays a message describing the exception. Subclasses should override this method.

class Exception :   object

Superclass Tree   (in declaration order)

Exception
        object

Subclass Tree  

Exception
        AbortImplicitSignal
        ActionRemappingTooComplexError
        BreakLoopSignal
        CircularExecException
        CompilerException
        DisambigException
                DisambigOrdinalOutOfRangeException
                StillAmbiguousException
                UnmatchedDisambigException
        EndOfFileException
        ExitActionSignal
        ExitSignal
        FileException
                FileClosedException
                FileCreationException
                FileIOException
                FileModeException
                FileNotFoundException
                FileOpenException
                FileSafetyException
                FileSyncException
        NetException
                NetSafetyException
                SocketDisconnectException
        ParserException
                ParseFailureException
                ReplacementCommandStringException
                RetryCommandTokensException
                TerminateCommandException
                        CancelCommandLineException
        ProgramException
        QuittingException
        RemapActionSignal
        RestartSignal
        RuntimeError
                StorageServerError
        SettingsNotSupportedException
        TokenizerError
                TokErrorNoMatch
        UnboundMultiMethod
                UnboundInheritedMultiMethod
        UnknownCharSetException

Global Objects  

(none)

Summary of Properties  

errmsg_ 

Summary of Methods  

construct  displayException  getExceptionMessage  showStackTrace 

Properties  

errmsg__main.t[693]

Private member: The error message passed to the constructor, if any. Note that this doesn't necessarily contain the actual displayed exception message, since displayException() can be overridden in subclasses to display additional parameters or other text entirely. The definitive message is the one that displayException() generates. If you want the displayed message as a string, use getExceptionMessage().

Methods  

construct (msg?, ...)_main.t[659]

construct, with an optional message describing the error

displayException ( )_main.t[667]
display the exception - should always be overridden

getExceptionMessage ( )_main.t[678]
Get the exception message as a string. This captures the output of displayException() and returns it a string. Use this instead of accessing errmsg_, since that member is private and might not reflect the actual displayed message.

showStackTrace (stackList)_main.t[702]
Display a stack trace, given a list of T3StackInfo objects. Note that, for efficiency, we do not by default cache a stack trace when an exception occurs; individual subclasses can obtain a stack trace if desired at construction and use the information to show a stack trace for the exception.

TADS 3 Library Manual
Generated on 5/16/2013 from TADS version 3.1.3