exceptions.h

#ifndef EXCEPTIONS_H__
#define EXCEPTIONS_H__

#include <vector>
#include <sstream>

#include <boost/exception/all.hpp>

/*
 * EXCEPTIONS
 */

// top level
struct Exception : virtual boost::exception, virtual std::exception {};

// top level per module
struct GuiError      : virtual Exception {};
struct SignalsError  : virtual Exception {};

// general errors
struct Segfault          : virtual Exception {};
struct IOError           : virtual Exception {};
struct SizeMismatchError : virtual Exception {};
struct UsageError        : virtual Exception {};
struct NullPointer       : virtual Exception {};
struct NotYetImplemented : virtual Exception {};

/*
 * THROW MACRO
 *
 * Usage:
 *
 * UTIL_THROW_EXCEPTION(ExceptionType, message)
 *
 * Example:
 *
 *   UTIL_THROW_EXCEPTION(
 *       UsageError,
 *       "number of ordered pizzas is negative: " << numPizzas << " < 0");
 */

#define UTIL_THROW_EXCEPTION(exception, message) \
	{ \
		std::stringstream __util_messageStream; \
		__util_messageStream << message; \
		BOOST_THROW_EXCEPTION(exception() << error_message(__util_messageStream.str()) << STACK_TRACE); \
	}

#define UTIL_RETHROW(e, message) \
	{ \
		std::stringstream __util_messageStream; \
		__util_messageStream << *boost::get_error_info<error_message>(e) << message; \
		BOOST_THROW_EXCEPTION(e << error_message(__util_messageStream.str())); \
	}

/*
 * TAGS
 */

class stack_trace_ {

public:

	stack_trace_();

	const std::vector<std::string>& get_stack_trace() const;

private:

	const std::string& get_program_name();

	std::string get_pid();

	void initialise_program_name();

	std::vector<std::string> _stack_trace;

	std::string _program_name;
};

std::ostream& operator<<(std::ostream& out, const stack_trace_& trace);

typedef boost::error_info<struct tag_error_message, std::string> error_message;

typedef boost::error_info<struct tag_stack_trace, stack_trace_>  stack_trace;
#define STACK_TRACE stack_trace(stack_trace_())

typedef boost::error_info<struct tag_mismatch_size1, int> mismatch_size1;
typedef boost::error_info<struct tag_mismatch_size2, int> mismatch_size2;

/*
 * HELPER FUNCTIONS
 */

void handleException(const boost::exception& e, std::ostream& out);

#endif // EXCEPTIONS_H__