2 Copyright (C) 2001-2006, William Joseph.
5 This file is part of GtkRadiant.
7 GtkRadiant is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 GtkRadiant is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GtkRadiant; if not, write to the Free Software
19 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
22 #if !defined(INCLUDED_DEBUGGING_DEBUGGING_H)
23 #define INCLUDED_DEBUGGING_DEBUGGING_H
26 /// \brief Debugging macros for fatal error/assert messages.
28 #include "stream/textstream.h"
30 #include "generic/static.h"
32 #if defined(_MSC_VER) && defined(_M_IX86)
33 #define DEBUGGER_BREAKPOINT() __asm { int 3 }
34 #elif defined (__i386__) && defined (__GNUC__) && __GNUC__ >= 2
35 #define DEBUGGER_BREAKPOINT() __asm__ __volatile__ ("int $03")
39 #define DEBUGGER_BREAKPOINT() raise(SIGTRAP);
43 #define STR2(x) STR(x)
44 #define FILE_LINE __FILE__ ":" STR2(__LINE__)
46 #if defined(_DEBUG) || 1
50 class DebugMessageHandler
53 virtual TextOutputStream& getOutputStream() = 0;
54 virtual bool handleMessage() = 0;
57 class NullDebugMessageHandler : public NullOutputStream, public DebugMessageHandler
60 virtual TextOutputStream& getOutputStream()
64 virtual bool handleMessage()
70 class DefaultDebugMessageHandler : public DebugMessageHandler
73 virtual TextOutputStream& getOutputStream()
75 return globalErrorStream();
77 virtual bool handleMessage()
80 return false; // send debug-break
87 class DebugMessageHandlerRef : public DefaultDebugMessageHandler
89 DebugMessageHandler* m_handler;
91 DebugMessageHandlerRef()
95 void setHandler(DebugMessageHandler& handler)
99 DebugMessageHandler& getHandler()
105 typedef Static<DebugMessageHandlerRef> GlobalDebugMessageHandler;
107 inline DebugMessageHandler& globalDebugMessageHandler()
109 return GlobalDebugMessageHandler::instance().getHandler();
112 #if defined(DEBUG_ASSERTS)
114 /// \brief Sends a \p message to the current debug-message-handler text-output-stream if \p condition evaluates to false.
115 #define ASSERT_MESSAGE(condition, message)\
118 globalDebugMessageHandler().getOutputStream() << FILE_LINE "\nassertion failure: " << message << "\n";\
119 if(!globalDebugMessageHandler().handleMessage()) { DEBUGGER_BREAKPOINT(); }\
122 /// \brief Sends a \p message to the current debug-message-handler text-output-stream.
123 #define ERROR_MESSAGE(message)\
124 globalDebugMessageHandler().getOutputStream() << FILE_LINE "\nruntime error: " << message << "\n";\
125 if(!globalDebugMessageHandler().handleMessage()) { DEBUGGER_BREAKPOINT(); } else\
127 #define ASSERT_NOTNULL(ptr) ASSERT_MESSAGE(ptr != 0, "pointer \"" #ptr "\" is null")
131 #define ASSERT_MESSAGE(condition, message)
132 #define ERROR_MESSAGE(message)
133 #define ASSERT_NOTNULL(ptr)