class corelinux::Exception

Exception is the base exception class used in the CoreLinux++ libraries.

Inheritance:

Public Classes

enum Severity

Exception Severity States

Public Methods

Exception( CharCptr why, CharCptr file, LineNum line, Severity severity = Exception::CONTINUABLE, bool outOfMemory = false )

Default Constructor

Exception( ExceptionCref crOther )

Copy constructor

void addUnwindInfo( CharCptr unwindInfo )

Append unwind information to the Exception.

const string& getFile( void ) const

Accessor

LineNumCref getLine( void ) const

Accessor

const Severity& getSeverity( void ) const

Accessor

const string& getUnwind( void ) const

Accessor

const string& getWhy( void ) const

Accessor

bool isOutOfMemory( void ) const

Accessor

ExceptionRef operator = ( ExceptionCref otherRef )

Assignment operator overload

bool operator==( ExceptionCref otherRef )

Comparisson operator overload

void setProcessFatalSeverity( void )

Change the severity to Severity::PROCESSFATAL

void setProcessTerminateSeverity( void )

Change the severity to Severity::PROCESSTERMINATE.

void setThreadFatalSeverity( void )

Change the severity to Severity::THREADFATAL

void setThreadTerminateSeverity( void )

Change the severity to Severity::THREADTERMINATE.

virtual ~Exception(void)

Virtual Destructor

Protected Methods

Exception( void )

Exceptions must have a reason.

Exception( CharCptr file, LineNum line, Severity severity = Exception::CONTINUABLE, bool outOfMemory = false )

Exception constructor for use by derivations

void setWhy( const string & )

Changes the exception reason

void setWhy( CharCptr )

Changes the exception reason

enum Severity

Exception Severity States

THREADFATAL

System can continue processing

PROCESSFATAL

Exception may prove to be thread fatal

THREADTERMINATE

Exception may prove to be process fatal

PROCESSTERMINATE

System should kill thread

System should exit

Exception( CharCptr why, CharCptr file, LineNum line, Severity severity = Exception::CONTINUABLE, bool outOfMemory = false )

Default Constructor

Parameters:

why - describes why the exception was thrown
file - The source module throwing the exception
line - The line of source throwing the exception
severity - The Exception::Severity of the Exception
outOfMemory - An out of memory indicator

Exception( ExceptionCref crOther )

Copy constructor

Parameters:

Exception - const reference

virtual ~Exception(void)

Virtual Destructor

ExceptionRef operator = ( ExceptionCref otherRef )

Assignment operator overload

Returns:

Exception reference to self

Parameters:

Exception - const reference

bool operator==( ExceptionCref otherRef )

Comparisson operator overload

Returns:

true if equal, false otherwise

Parameters:

Exception - const reference

const string& getFile( void ) const

Accessor

Returns:

Const reference to module name where Exception was thrown

LineNumCref getLine( void ) const

Accessor

Returns:

Const reference to line number in module where Exception was thrown

const string& getWhy( void ) const

Accessor

Returns:

Const reference to Exception explanation.

const Severity& getSeverity( void ) const

Accessor

Returns:

Const reference to Severity of Exception.

const string& getUnwind( void ) const

Accessor

Returns:

Const reference to the unwind stack description.

bool isOutOfMemory( void ) const

Accessor

Returns:

true if out of memory exception, false otherwise

void addUnwindInfo( CharCptr unwindInfo )

Append unwind information to the Exception. Clients should use this service to identify themselves and specify any changes to severity.

void setThreadFatalSeverity( void )

Change the severity to Severity::THREADFATAL

void setProcessFatalSeverity( void )

Change the severity to Severity::PROCESSFATAL

void setThreadTerminateSeverity( void )

Change the severity to Severity::THREADTERMINATE. This is useful to the catcher that the thread should be cleaned up.

void setProcessTerminateSeverity( void )

Change the severity to Severity::PROCESSTERMINATE. This is useful to the catcher that the process should exit

Exception( void )

Exceptions must have a reason. Default constructor is not allowed.

Exception( CharCptr file, LineNum line, Severity severity = Exception::CONTINUABLE, bool outOfMemory = false )

Exception constructor for use by derivations

void setWhy( const string & )

Changes the exception reason

void setWhy( CharCptr )

Changes the exception reason

Direct child classes:

ThreadException
StorageException
SemaphoreException
NullPointerException
IteratorException
CompositeException
CommandFrameException
AbstractFactoryException