Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/libraries/util/Exception.h @ 8733

Last change on this file since 8733 was 8706, checked in by dafrick, 13 years ago

Merging presentation branch back into trunk.
There are many new features and also a lot of other changes and bugfixes, if you want to know, digg through the svn log.
Not everything is yet working as it should, but it should be fairly stable. If you habe any bug reports, just send me an email.

  • Property svn:eol-style set to native
File size: 8.4 KB
RevLine 
[1638]1/*
2 *   ORXONOX - the hottest 3D action shooter ever to exist
3 *                    > www.orxonox.net <
4 *
5 *
6 *   License notice:
7 *
8 *   This program is free software; you can redistribute it and/or
9 *   modify it under the terms of the GNU General Public License
10 *   as published by the Free Software Foundation; either version 2
11 *   of the License, or (at your option) any later version.
12 *
13 *   This program is distributed in the hope that it will be useful,
14 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 *   GNU General Public License for more details.
17 *
18 *   You should have received a copy of the GNU General Public License
19 *   along with this program; if not, write to the Free Software
20 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
21 *
22 *   Author:
23 *      Reto Grieder
24 *   Co-authors:
25 *      ...
26 *
27 */
28
29/**
[7401]30    @defgroup ExceptionAssertion Exceptions and assertions
31    @ingroup Util
32*/
33
34/**
[1638]35@file
[7401]36@ingroup ExceptionAssertion
[1638]37@brief
[3196]38    Declaration of facilities to handle exceptions.
[7401]39@details
40    Any exception thrown should inherit from orxonox::Exception. There is a macro
41    \ref CREATE_ORXONOX_EXCEPTION to create a new exception (you can find a list of
42    available exceptions in the docs of this file). <br>
43    Throwing exception is also very simple:
44    @code
45        ThrowException(General, "Something went wrong");
46    @endcode
47    (\c General is a type of exception, see docs of this file) <br>
48    The exception will automatically contain information about file, line number
49    and function name it occurred in. <br><br>
50    There is also some magic you can do for numbers, etc.:
51    @code
52        ThrowException(General, "Error code: " << myInt << ". more info...");
53    @endcode
54    It works with an std::ostringstream, so you can feed it all sorts of values.
[1638]55*/
56
57#ifndef _Exception_H__
58#define _Exception_H__
59
[1764]60#include "UtilPrereqs.h"
[1638]61
[3196]62#include <exception>
63#include <sstream>
[1638]64#include <string>
[1764]65#include "Debug.h"
[1638]66
67namespace orxonox
68{
[7401]69    /** Base class for all exceptions (derived from std::exception).
[3196]70    @details
71        This class provides support for information about the file, the line
[7401]72        and the function the error occurred.
73    @see Exception.h
[3196]74    */
[1764]75    class _UtilExport Exception : public std::exception
[1638]76    {
77    public:
[3196]78        /**
79        @brief
80            Creates the exception but doesn't yet compose the full descrption (because of the virtual functions)
81        @param description
82            Exception description as string. This message is supposed to help developers!
[7401]83        @param lineNumber
84            The number of the code-line in which the exception occurred
85        @param filename
86            The file in which the exception occurred
87        @param functionName
88            The function in which the exception occurred
[3196]89        */
90        Exception(const std::string& description, unsigned int lineNumber,
[2103]91                  const char* filename, const char* functionName);
[3196]92        //! Simplified constructor with just a description. If you need more, use the other one.
[1638]93        Exception(const std::string& description);
94
[3196]95        //! Needed for compatibility with std::exception
[1638]96        virtual ~Exception() throw() { }
[7401]97        //! Returns the error description
[3280]98        const char* what() const throw();
[1638]99
[7401]100        /** Returns a full description with type, line, file and function
101        @remarks
102            The composed full description gets stored to fullDescription_. But for compliance
103            with std::exception, this method has to be const. Hence fullDescription_ is declared
104            as mutable.
105        */
[1664]106        virtual const std::string& getFullDescription() const;
[3196]107        //! Returns the string name of the exception type
[1638]108        virtual std::string        getTypeName()        const = 0;
[3196]109        //! Returns the short developer written exception
[1638]110        virtual const std::string& getDescription()     const { return this->description_; }
[3196]111        //! Returns the line number on which the exception occurred.
[8706]112        virtual unsigned int getLineNumber()            const { return this->lineNumber_; }
[3196]113        //! Returns the function in which the exception occurred.
[1638]114        virtual const std::string& getFunctionName()    const { return this->functionName_; }
[3196]115        //! Returns the filename in which the exception occurred.
116        virtual const std::string& getFilename()        const { return this->filename_; }
[1638]117
[5747]118        /**
119        @brief
120            Retrieves information from an exception caught with "..."
121            Works for std::exception and CEGUI::Exception
122        @remarks
123            Never ever call this function without an exception in the stack!
124        */
125        static std::string handleMessage();
126
[1638]127    protected:
[3196]128        std::string description_;             //!< User typed text about why the exception occurred
129        unsigned int lineNumber_;             //!< Line on which the exception occurred
130        std::string functionName_;            //!< Function (including namespace and class) where the exception occurred
131        std::string filename_;                //!< File where the exception occurred
[1670]132        // mutable because "what()" is a const method
[3196]133        mutable std::string fullDescription_; //!< Full description with line, file and function
[1638]134    };
135
[7401]136//! Creates a new type of exception that inherits from orxonox::Exception
[2171]137#define CREATE_ORXONOX_EXCEPTION(ExceptionName)                                     \
138    class ExceptionName##Exception : public Exception                               \
139    {                                                                               \
140    public:                                                                         \
[3196]141        ExceptionName##Exception(const std::string& description,                    \
142                unsigned int lineNumber, const char* filename,                      \
143                const char* functionName)                                           \
144            : Exception(description, lineNumber, filename, functionName)            \
[2662]145        { }                                                                         \
[2171]146                                                                                    \
147        ExceptionName##Exception(const std::string& description)                    \
[3196]148            : Exception(description)                                                \
[2662]149        { }                                                                         \
[2171]150                                                                                    \
151        ~ExceptionName##Exception() throw() { }                                     \
152                                                                                    \
153        std::string getTypeName() const { return #ExceptionName; }                  \
[3196]154    }
[1638]155
[2171]156    // Creates all possible exception types.
157    // If you want to add a new type, simply copy and adjust a new line here.
[1660]158    CREATE_ORXONOX_EXCEPTION(General);
159    CREATE_ORXONOX_EXCEPTION(FileNotFound);
[1663]160    CREATE_ORXONOX_EXCEPTION(Argument);
[2662]161    CREATE_ORXONOX_EXCEPTION(PhysicsViolation);
162    CREATE_ORXONOX_EXCEPTION(ParseError);
[1660]163    CREATE_ORXONOX_EXCEPTION(PluginsNotFound);
164    CREATE_ORXONOX_EXCEPTION(InitialisationFailed);
[6417]165    CREATE_ORXONOX_EXCEPTION(InitialisationAborted);
[1660]166    CREATE_ORXONOX_EXCEPTION(NotImplemented);
167    CREATE_ORXONOX_EXCEPTION(GameState);
[2171]168    CREATE_ORXONOX_EXCEPTION(NoGraphics);
169    CREATE_ORXONOX_EXCEPTION(AbortLoading);
[1638]170
[7401]171    /** Helper function that forwards an exception and displays the message.
[3196]172    @details
173        This is necessary because only when using 'throw' the objects storage is managed.
[2662]174    */
175    template <class T>
[3196]176    inline const T& exceptionThrowerHelper(const T& exception)
[2662]177    {
178        // let the catcher decide whether to display the message below level 4
179        COUT(4) << exception.getFullDescription() << std::endl;
180        return exception;
181    }
[1638]182
[7401]183/** Throws an exception and logs a message beforehand.
[3196]184@param type
185    Type of the exception as literal (General, Initialisation, etc.)
186@param description
187    Exception description as string
[7401]188@see Exception.h
[3196]189*/
[3280]190#define ThrowException(type, description) \
[3196]191    throw orxonox::exceptionThrowerHelper(type##Exception(static_cast<std::ostringstream&>(std::ostringstream().flush() << description).str(), __LINE__, __FILE__, __FUNCTIONNAME__))
[2662]192
[3196]193} /* namespace orxonox */
[1642]194
[1638]195#endif /* _Exception_H__ */
Note: See TracBrowser for help on using the repository browser.