Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/branches/network64/src/util/Exception.h @ 2210

Last change on this file since 2210 was 2171, checked in by landauf, 16 years ago

merged revisions 2111-2170 from objecthierarchy branch back to trunk.

File size: 5.1 KB
Line 
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/**
30@file
31@brief
32    Declaration of the Exception class.
33*/
34
35#ifndef _Exception_H__
36#define _Exception_H__
37
38#include "UtilPrereqs.h"
39
40#include <string>
41#include <exception>
42#include <cassert>
43#include "Debug.h"
44
45namespace orxonox
46{
47    class _UtilExport Exception : public std::exception
48    {
49    public:
50
51        Exception(const std::string& description, int lineNumber,
52                  const char* filename, const char* functionName);
53        Exception(const std::string& description);
54
55        /// Needed for  compatibility with std::exception (from Ogre::Exception)
56        virtual ~Exception() throw() { }
57
58        virtual const std::string& getFullDescription() const;
59        virtual std::string        getTypeName()        const = 0;
60        virtual const std::string& getDescription()     const { return this->description_; }
61        virtual const int          getLineNumber()      const { return this->lineNumber_; }
62        virtual const std::string& getFunctionName()    const { return this->functionName_; }
63
64        /// Override std::exception::what (from Ogre::Exception)
65        const char* what() const throw() { return getFullDescription().c_str(); }
66
67    protected:
68        std::string description_;
69        int lineNumber_;
70        std::string functionName_;
71        std::string filename_;
72        // mutable because "what()" is a const method
73        mutable std::string fullDescription_;
74    };
75
76
77#define CREATE_ORXONOX_EXCEPTION(ExceptionName)                                     \
78    class ExceptionName##Exception : public Exception                               \
79    {                                                                               \
80    public:                                                                         \
81        ExceptionName##Exception(const std::string& description, int lineNumber,    \
82                  const char* filename, const char* functionName)                   \
83                  : Exception(description, lineNumber, filename, functionName)      \
84        {                                                                           \
85            /* Let the catcher decide whether to display the message below level 4  \
86               Note: Don't place this code in Exception c'tor because getTypeName() \
87               is still pure virtual at that time. */                               \
88            COUT(4) << this->getFullDescription() << std::endl;                     \
89        }                                                                           \
90                                                                                    \
91        ExceptionName##Exception(const std::string& description)                    \
92                  : Exception(description)                                          \
93        { COUT(4) << this->getFullDescription() << std::endl; }                     \
94                                                                                    \
95        ~ExceptionName##Exception() throw() { }                                     \
96                                                                                    \
97        std::string getTypeName() const { return #ExceptionName; }                  \
98    };
99
100    // Creates all possible exception types.
101    // If you want to add a new type, simply copy and adjust a new line here.
102    CREATE_ORXONOX_EXCEPTION(General);
103    CREATE_ORXONOX_EXCEPTION(FileNotFound);
104    CREATE_ORXONOX_EXCEPTION(Argument);
105    CREATE_ORXONOX_EXCEPTION(PluginsNotFound);
106    CREATE_ORXONOX_EXCEPTION(InitialisationFailed);
107    CREATE_ORXONOX_EXCEPTION(NotImplemented);
108    CREATE_ORXONOX_EXCEPTION(GameState);
109    CREATE_ORXONOX_EXCEPTION(NoGraphics);
110    CREATE_ORXONOX_EXCEPTION(AbortLoading);
111}
112
113#define ThrowException(Type, Description) \
114    throw Type##Exception(Description, __LINE__, __FILE__, __FUNCTIONNAME__)
115
116    // define an assert macro that can display a message
117#ifndef NDEBUG
118#define OrxAssert(Assertion, ErrorMessage) \
119    Assertion ? ((void)0) : (void)(orxonox::OutputHandler::getOutStream().setOutputLevel(ORX_ERROR) << ErrorMessage << std::endl); \
120    assert(Assertion)
121#else
122#define OrxAssert(condition, errorMessage)  ((void)0)
123#endif
124
125#endif /* _Exception_H__ */
Note: See TracBrowser for help on using the repository browser.