Exception class | _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