Code is all reorganized. We're about ready to release. I should write up a

little explenation of the arrangement.

1 files changed, 190 insertions, 0 deletions

diff --git a/src/stable/exceptionbase.h b/src/stable/exceptionbase.h
new file mode 100644
index 0000000..b6ad9ca
--- /dev/null
+++ b/src/stable/exceptionbase.h
@@ -0,0 +1,190 @@
+/*
+ * Copyright (C) 2007-2011 Xagasoft, All rights reserved.
+ *
+ * This file is part of the libbu++ library and is released under the
+ * terms of the license contained in the file LICENSE.
+ */
+
+#ifndef BU_EXCEPTION_BASE_H
+#define BU_EXCEPTION_BASE_H
+
+#include <exception>
+#include <stdarg.h>
+
+// This shouldn't normally be defined here, I don't think it's all that portable
+// and it also changes the class interface, we should find out how much of
+// an issue that is, we could just put in an empty getBacktrace() function for
+// when you don't have support for it...
+
+namespace Bu
+{
+        /**
+         * A generalized Exception base class.  This is nice for making general and
+         * flexible child classes that can create new error code classes.
+         *
+         * In order to create your own exception class use these two lines.
+         * 
+         * in your header:  subExceptionDecl( NewClassName );
+         * 
+         * in your source:  subExcpetienDef( NewClassName );
+         */
+        class ExceptionBase : public std::exception
+        {
+        public:
+                /**
+                 * Construct an exception with an error code of zero, but with a
+                 * description.  The use of this is not reccomended most of the time,
+                 * it's generally best to include an error code with the exception so
+                 * your program can handle the exception in a better way.
+                 * @param sFormat The format of the text.  See printf for more info.
+                 */
+                ExceptionBase( const char *sFormat, ... ) throw();
+                
+                /**
+                 * 
+                 * @param nCode 
+                 * @param sFormat
+                 */
+                ExceptionBase( int nCode, const char *sFormat, ... ) throw();
+                
+                /**
+                 * 
+                 * @param nCode 
+                 * @return 
+                 */
+                ExceptionBase( int nCode=0 ) throw();
+
+                ExceptionBase( const ExceptionBase &e ) throw ();
+                
+                /**
+                 * 
+                 * @return 
+                 */
+                virtual ~ExceptionBase() throw();
+
+                /**
+                 * 
+                 * @return 
+                 */
+                virtual const char *what() const throw();
+                
+                /**
+                 * 
+                 * @return 
+                 */
+                int getErrorCode();
+                
+                /**
+                 * 
+                 * @param lpFormat 
+                 * @param vargs 
+                 */
+                void setWhat( const char *lpFormat, va_list &vargs );
+
+                /**
+                 *
+                 * @param lpText
+                 */
+                void setWhat( const char *lpText );
+
+        private:
+                int nErrorCode; /**< The code for the error that occured. */
+                char *sWhat;    /**< The text string telling people what went wrong. */
+        };
+}
+
+#define subExceptionDecl( name )                                                                                        \
+class name : public Bu::ExceptionBase                                                                                   \
+{                                                                                                                                                       \
+        public:                                                                                                                                 \
+                name( const char *sFormat, ... ) throw ();                                                      \
+                name( int nCode, const char *sFormat, ... ) throw();                            \
+                name( int nCode=0 ) throw ();                                                                           \
+                name( const name &e ) throw ();                                                                         \
+};
+
+#define subExceptionDeclChild( name, parent )                                                           \
+class name : public parent                                                                                                      \
+{                                                                                                                                                       \
+        public:                                                                                                                                 \
+                name( const char *sFormat, ... ) throw ();                                                      \
+                name( int nCode, const char *sFormat, ... ) throw();                            \
+                name( int nCode=0 ) throw ();                                                                           \
+                name( const name &e ) throw ();                                                                         \
+};
+
+#define subExceptionDeclBegin( name )                                                                           \
+class name : public Bu::ExceptionBase                                                                           \
+{                                                                                                                                                       \
+        public:                                                                                                                                 \
+                name( const char *sFormat, ... ) throw ();                                                      \
+                name( int nCode, const char *sFormat, ... ) throw();                            \
+                name( int nCode=0 ) throw ();                                                                           \
+                name( const name &e ) throw ();
+
+#define subExceptionDeclEnd()                                                                                           \
+};
+
+#define subExceptionDef( name )                                                                                         \
+name::name( const char *lpFormat, ... ) throw() :                                                       \
+        ExceptionBase( 0 )                                                                                                              \
+{                                                                                                                                                       \
+        va_list ap;                                                                                                                             \
+        va_start( ap, lpFormat );                                                                                               \
+        setWhat( lpFormat, ap );                                                                                                \
+        va_end( ap );                                                                                                                   \
+}                                                                                                                                                       \
+name::name( int nCode, const char *lpFormat, ... ) throw() :                            \
+        ExceptionBase( nCode )                                                                                                  \
+{                                                                                                                                                       \
+        va_list ap;                                                                                                                             \
+        va_start( ap, lpFormat );                                                                                               \
+        setWhat( lpFormat, ap );                                                                                                \
+        va_end( ap );                                                                                                                   \
+}                                                                                                                                                       \
+name::name( int nCode ) throw() :                                                                                       \
+        ExceptionBase( nCode )                                                                                                  \
+{                                                                                                                                                       \
+}                                                                                                                                                       \
+name::name( const name &e ) throw() :                                                                           \
+        ExceptionBase( e )                                                                                                              \
+{                                                                                                                                                       \
+}
+
+#define subExceptionDefChild( name, parent )                                                            \
+name::name( const char *lpFormat, ... ) throw() :                                                       \
+        parent( 0 )                                                                                                                             \
+{                                                                                                                                                       \
+        va_list ap;                                                                                                                             \
+        va_start( ap, lpFormat );                                                                                               \
+        setWhat( lpFormat, ap );                                                                                                \
+        va_end( ap );                                                                                                                   \
+}                                                                                                                                                       \
+name::name( int nCode, const char *lpFormat, ... ) throw() :                            \
+        parent( nCode )                                                                                                                 \
+{                                                                                                                                                       \
+        va_list ap;                                                                                                                             \
+        va_start( ap, lpFormat );                                                                                               \
+        setWhat( lpFormat, ap );                                                                                                \
+        va_end( ap );                                                                                                                   \
+}                                                                                                                                                       \
+name::name( int nCode ) throw() :                                                                                       \
+        parent( nCode )                                                                                                                 \
+{                                                                                                                                                       \
+}                                                                                                                                                       \
+name::name( const name &e ) throw() :                                                                           \
+        ExceptionBase( e )                                                                                                              \
+{                                                                                                                                                       \
+}
+
+namespace Bu
+{
+        // Exceptions that are so general they could be used anywhere go here.
+        class UnsupportedException : public Bu::ExceptionBase
+        {
+        public:
+                UnsupportedException() throw ();
+        };
+}
+
+#endif