Aztec® Programming Language

Version 1.0 Alpha

Copyright © 2010-2013

Cold Spring® Development Group

All Rights Reserved

Download Aztec

Site Help

aztec.system.ExceptionEvent

public abstract class ExceptionEvent from<Event>

Base

Event

ExceptionEvent

ExceptionEvent is an abstract class which provides a framework for all Aztec exception classes. Exceptions are special events which are handled using the exceptions/handle/cleanup construct. Being events, they can also be handled using standard event handling techniques. The Thread class supports adding an event handler for exceptions (filtered or not), and if registered from a thread other than the thread where the exception is fired, the processing of the exception by the registered handler can take place in parallel with the exceptions/handle processing within the thread where the exception was fired.

ExceptionEvent Methods

ExceptionEvent() Constructor for the ExceptionEvent class
Fire() Fires the exception causing exceptions/handle processing to take place within the thread
Thread() Reference to the Thread object where the exception was fired
ModuleName() Name of the module where the exception was fired
ModuleLine() Line number within the module where the exception was fired

Derived Classes

See Also

  


ExceptionEvent()

public method ExceptionEvent()

Parameters

None

Return Value

None

Description

Constructor for the ExceptionEvent class.

 

ExceptionEvent Class


Fire()

public method Fire()

Parameters

None

Return Value

None

Description

This method initiates Aztec exception handling at the point where this method. The VM searches for an exceptions/handle block for a match with the type of exception being fired. If found, control is transferred to that construct (per standard Aztec exception handling rules). If not found, then an unhandled exception run-time error occurs.

 

In addition, if one or more Exception handlers are registered with the thread where the exception was fired, then standard Aztec event handling can proceed using the exception event object (if it passes the "filter"). If the thread which registered the handler is different than the thread where it was fired, the event will be processed by that thread at the same time that this thread processes the exceptions/handle construct.

 

ExceptionEvent Class


Thread()

public method<Thread> Thread()

Parameters

None

Return Value

Thread object where exception was fired

Description

This method returns a reference to the Thread object where the exception was actually fired..

 

ExceptionEvent Class


ModuleName()

public method<string> ModuleName()

Parameters

None

Return Value

Module name where exception was fired

Description

This method returns the name of the module where the exception was fired.

 

ExceptionEvent Class


ModuleLine()

public method<int> ModuleLine()

Parameters

None

Return Value

Module line where exception was fired

Description

This method returns the line number within the module where the exception was fired.

 

ExceptionEvent Class

 

Copyright © 2010-2013

Cold Spring Development Group

All Rights Reserved

Download Aztec