OBError Class Reference

Customizable error handling and logging -- store a message, including the method yielding the error, causes, etc. More...

#include <openbabel/oberror.h>

List of all members.

Public Member Functions
	OBError (const std::string &method="", const std::string &errorMsg="", const std::string &explanation="", const std::string &possibleCause="", const std::string &suggestedRemedy="", const obMessageLevel=obDebug)
std::string	message (void) const
std::string	GetMethod () const
std::string	GetError () const
std::string	GetExplanation () const
std::string	GetPossibleCause () const
std::string	GetSuggestedRemedy () const
obMessageLevel	GetLevel () const
bool	operator== (const OBError &) const
Protected Attributes
std::string	_method
std::string	_errorMsg
std::string	_explanation
std::string	_possibleCause
std::string	_suggestedRemedy
obMessageLevel	_level
Friends
std::ostream &	operator<< (std::ostream &os, const OBError &er)

---

Detailed Description

Customizable error handling and logging -- store a message, including the method yielding the error, causes, etc.

---

Constructor & Destructor Documentation

OBError	(	const std::string &	method = "",
		const std::string &	errorMsg = "",
		const std::string &	explanation = "",
		const std::string &	possibleCause = "",
		const std::string &	suggestedRemedy = "",
		const obMessageLevel	level = obDebug
	)

Constructor for an error message e.g. OBError(__FUNCTION__, " message ").

---

Member Function Documentation

string message

(

void

)

const

Returns:

A formatted message string, including optional explanations, etc.

Referenced by OBMessageHandler::GetMessagesOfLevel().

std::string GetMethod

(

)

const [inline]

Returns:

The method which caused this error (typically supplied via the __FUNCTION__ compiler macro

std::string GetError

(

)

const [inline]

Returns:

The main error message

Referenced by OBError::operator==().

std::string GetExplanation

(

)

const [inline]

Returns:

A more detailed explanation of the error (optional)

std::string GetPossibleCause

(

)

const [inline]

Returns:

A possible cause for the error (optional)

std::string GetSuggestedRemedy

(

)

const [inline]

Returns:

The suggested workaround or remedy for the error (optional)

obMessageLevel GetLevel

(

)

const [inline]

Returns:

The severity level of this error

Referenced by OBMessageHandler::GetMessagesOfLevel(), and OBMessageHandler::ThrowError().

bool operator==

(

const OBError &

other

)

const

---

Friends And Related Function Documentation

std::ostream& operator<<	(	std::ostream &	os,
		const OBError &	er
	)			[friend]

Output a formatted message string.

---

Member Data Documentation

std::string _method [protected]

The method causing the error (typically from the compiler macro __FUNCTION__).

Referenced by OBError::message().

std::string _errorMsg [protected]

The actual error message.

Referenced by OBError::message().

std::string _explanation [protected]

Optional explanation message: more detailed than the brief error.

Referenced by OBError::message().

std::string _possibleCause [protected]

Optional cause message.

Referenced by OBError::message().

std::string _suggestedRemedy [protected]

Optional workaround or remedy.

Referenced by OBError::message().

obMessageLevel _level [protected]

The severity level: used for filtering via OBMessageHandler.

Referenced by OBError::message().

---

The documentation for this class was generated from the following files:

• oberror.h
• oberror.cpp