BALL::Exception::GeneralException Class Reference
[Common Definitions]
#include <BALL/COMMON/exception.h>
List of all members.
Detailed Description
General exception class. This class is intended as a base class for all other exceptions. Each exception class should define a constructor taking a string and an int as parameters. These two values are interpreted as the current filename and line number and is usually printed in case of an uncaught exception. To support this feature, each throw directive should look as follows:
throw Exception::GeneralException(__FILE__, __LINE__);
__FILE__
and __LINE__
are built-in preprocessor macros that hold the desired information.
- BALL provides its own terminate handler. This handler extracts as much information as possible from the exception, prints it to
cerr
and Log , and finally calls exits the program cleanly (with exit code 1). This can be rather inconvenient for debugging, since you are told where the exception was thrown, but in general you do not know anything about the context. Therefore terminate
can also create a core dump. Using a debugger (e.g. dbx or gdb) you can then create a stack traceback. To create a core dump, you should set the environment variable BALL_DUMP_CORE
to any (non empty) value.
Constructor & Destructor Documentation
BALL::Exception::GeneralException::GeneralException |
( |
|
) |
|
BALL::Exception::GeneralException::GeneralException |
( |
const char * |
file, |
|
|
int |
line | |
|
) |
| | |
BALL::Exception::GeneralException::GeneralException |
( |
const char * |
file, |
|
|
int |
line, |
|
|
const String & |
name, |
|
|
const String & |
message | |
|
) |
| | |
BALL::Exception::GeneralException::GeneralException |
( |
const GeneralException & |
exception |
) |
|
virtual BALL::Exception::GeneralException::~GeneralException |
( |
|
) |
throw () [virtual] |
Member Function Documentation
const char* BALL::Exception::GeneralException::getFile |
( |
|
) |
const |
Returns the file where it occured.
int BALL::Exception::GeneralException::getLine |
( |
|
) |
const |
Returns the line number where it occured.
const char* BALL::Exception::GeneralException::getMessage |
( |
|
) |
const |
Returns the error message of the exception.
const char* BALL::Exception::GeneralException::getName |
( |
|
) |
const |
Returns the name of the exception.
void BALL::Exception::GeneralException::setMessage |
( |
const std::string & |
message |
) |
|
Modify the exception's error message.
Member Data Documentation