The whole thing

exceptions.h

@@ -0,0 +1,79 @@
+#ifndef __EXCEPTIONS_H__
+#define __EXCEPTIONS_H__
+
+#include <string>
+#include <sstream>
+#include <exception>
+
+//! This macro should be used when calling an exception
+/*!   for example :
+     throw( Exception( "Shit happens", E_INFOS );
+*/
+#define E_INFOS __FUNCTION__,__FILE__,__LINE__
+
+
+//! This macro should be used to declare an exception
+/*! The second argument is the name of the exception class
+    The first argument is the name of the base class
+    for example :
+      EXCEPTION(Exception,Buddhist_Observation);
+      creates an new exception class "Buddhist_Observation", derived from the base "Exception"
+*/
+#define EXCEPTION(Super,Current) class Current : public Super {public: Current ( const std::string & desc, const std::string & func="?", const std::string & f="?", const int l=-1 ) : Super (desc,func,f,l) {name = #Current;} }
+
+
+/** A shortcut to throw an exception without having to type ",E_INFOS"
+ * and that could take streamed-formatted input instead of plain strings.
+ *
+ * Example:
+ *      RAISE( Buddhist_Observation, "There is " << 0 << " shit that happens" );
+ */
+#define RAISE( Err, msg ) {std::ostringstream oss; oss << msg; throw( Err(oss.str(), E_INFOS) );}
+
+
+//! This is the base class for all exceptions in oMetah
+class Exception : public std::exception
+{
+protected:
+    //! Name of the current exception class
+    std::string name;
+
+    //! Description of the exception
+    std::string description;
+
+    //! Function where the exception has been raised
+    std::string function;
+
+    //! File where the exception has been raised
+    std::string file;
+
+    //! Line where the exception has been raised
+    int line;
+
+public:
+    //! Constructor of the exception
+    /*!
+        This constructor is not supposed to be used with hand-made location arguments
+        but with metadata provided by the compiler.
+
+        Use the E_INFOS macro to raise the exception, for example :
+            throw( Exception( "Shit evolves", E_INFOS );
+    */
+    Exception( const std::string & desc, const std::string & func, const std::string & f, const int l ) 
+        : description(desc), function(func), file(f), line(l) {}
+
+    //! The destructor is not allowed to throw exceptions
+    virtual ~Exception() throw () {}
+
+    //! The method to use for printing the complete description of the exception
+    std::string what()
+    {
+        std::ostringstream msg;
+        msg << description << " (<" << name << "> in " << function << " at " << file << ":" << line << ")";
+
+        return msg.str();
+    }
+};
+
+#endif // __EXCEPTIONS_H__
+