jem::RuntimeException Class Reference

Signals a runtime exception. More...

#include <jem/base/RuntimeException.h>

Inherits jem::Throwable.

Inherited by jem::AssertException, jem::ClassCastException, jem::IllegalArgumentException, jem::IllegalIndexException, jem::mp::MPException, jem::NullPointerException, jem::PrecheckException, jem::RangeException, jem::util::EmptySequenceException, jive::fem::InvalidBlocksException, and jive::mp::InvalidBordersException.

Public Member Functions
	RuntimeException (const String &place=String(), const String &msg=String())
	Constructs a RuntimeException. More...
virtual String	name () const
	Returns the class name of this exception. More...
Public Member Functions inherited from jem::Throwable
	Throwable (const String &place=String(), Const String &msg=String())
	Creates a new Throwable instance. More...
	Throwable (const Throwable &rhs)
	Creates a copy of another Throwable instance. More...
	~Throwable ()
	Destructor. More...
virtual String	where () const
	Returns a string describing the context in which this Throwable was thrown. More...
virtual String	what () const
	Returns a string describing why this Throwable was thrown. More...

Detailed Description

An object of the class RuntimeException signals an error condition that should normally not occur in a correct program. Such an error condition is typically caused by a programming mistake or by a shortage of a system resource such as memory. Functions throwing a RuntimeException do not necessarily have to document this fact.

If a RuntimeException is constructed when the environment variable JEM_ABORT_ON_EXCEPTION has been set, then the program is terminated by calling the standard function abort. This is useful if you want to create a core dump containing a trace of the call stack.

Constructor & Destructor Documentation

jem::RuntimeException::RuntimeException ( const String &  place = String(), const String &  msg = String()  )

explicit

Constructs a RuntimeException given a context and message string. If the environment variable JEM_ABORT_ON_EXCEPTION has been set, the program is aborted.

Parameters

place	- a string describing the context in which this exception was thrown.
msg	- a string describing why this exception was thrown.

Member Function Documentation

virtual String jem::RuntimeException::name ( ) const

virtual

Returns the full class name – including namespaces – of this Throwable instance. This function should be overriden by derived classes. For instance, a class named flip::FlopException should return the string "flip::FlopException".

Returns

A string describing the class name of this object.

Reimplemented from jem::Throwable.

Reimplemented in jem::IllegalIndexException, jive::fem::InvalidBlocksException, jive::mp::InvalidBordersException, jem::mp::MPException, jem::ClassCastException, jem::IllegalArgumentException, jem::PrecheckException, jem::RangeException, jem::util::EmptySequenceException, jem::AssertException, and jem::NullPointerException.