nevrax.org : docs

debug.h File Reference

More...

+Go to the source code of this file. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Namespaces
namespace	NLMISC
Defines
#define	nldebug NLMISC::createDebug (), NLMISC::DebugLog->setPosition( __LINE__, __FILE__ ), NLMISC::DebugLog->displayNL
	Log a debug string. More...
#define	nlinfo NLMISC::createDebug (), NLMISC::InfoLog->setPosition( __LINE__, __FILE__ ), NLMISC::InfoLog->displayNL
	Same as nldebug but it will be display in debug and in release mode. More...
#define	nlwarning NLMISC::createDebug (), NLMISC::WarningLog->setPosition( __LINE__, __FILE__ ), NLMISC::WarningLog->displayNL
	Same as nlinfo but you have to call this macro when something goes wrong but it's not a fatal error, the program could continue. More...
#define	nlerror NLMISC::createDebug (), NLMISC::ErrorLog->setPosition( __LINE__, __FILE__ ), NLMISC::nlFatalError
	Same as nlinfo but you have to call it when you have a fatal error, this macro display the text and exit* the application automatically.* More...
#define	nlerrornoex NLMISC::createDebug (), NLMISC::ErrorLog->setPosition( __LINE__, __FILE__ ), NLMISC::nlError
	Same as nlerror but it doesn't generate any exceptions. More...
#define	NLMISC_BREAKPOINT abort()
#define	nlassert(exp)
	Try the assertion of `exp`. More...
#define	nlassertonce(exp)
	Same behaviour as nlassert but the assertion will be test on time only. More...
#define	nlassertex(exp, str)
	Same behaviour as nlassert but add a user defined `str` variables args string that will be display with the assert message. More...
#define	nlverify(exp)
	Same behaviour as nlassert but the `exp` will be executed in release mode too (but not tested). More...
#define	nlverifyonce(exp)
	Same behaviour as nlassertonce but it will execute `exp` in debug and release mode. More...
#define	nlverifyex(exp, str)
	Same behaviour as nlassertex but it will execute `exp` in debug and release mode. More...
#define	nlstop
	It stop the application at this point. More...
#define	nlstoponce
	Same as nlassertonce(false);. More...
#define	nlstopex(str)
	Same as nlassertex(false,exp);. More...
#define	assert(a) you_must_not_use_assert___use_nl_assert___read_debug_h_file
#define	nlctassert(cond) sizeof(uint[(cond) ? 1 : 0]);
	Compile time assertion. More...

{ \ + static bool ignoreNextTime = false; \ + if (!ignoreNextTime && !(exp)) { \ + NLMISC::DebugNeedAssert = false; \ + NLMISC::createDebug (); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime = ignoreNextTime; \ + else \ + NLMISC::DebugNeedAssert = true; \ + NLMISC::AssertLog->setPosition (__LINE__, __FILE__); \ + NLMISC::AssertLog->displayNL ("\"%s\" ", #exp); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + ignoreNextTime = NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime; \ + if (NLMISC::DebugNeedAssert) \ + NLMISC_BREAKPOINT; \ + } \ +}

{ \
+        static bool ignoreNextTime = false; \
+        if (!ignoreNextTime && !(exp)) { \
+                NLMISC::DebugNeedAssert = false; \
+                NLMISC::createDebug (); \
+                if (NLMISC::DefaultMsgBoxDisplayer) \
+                        NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime = ignoreNextTime; \
+                else \
+                        NLMISC::DebugNeedAssert = true; \
+                NLMISC::AssertLog->setPosition (__LINE__, __FILE__); \
+                NLMISC::AssertLog->display ("\"%s\" ", #exp); \
+                NLMISC::AssertLog->displayRawNL str; \
+                if (NLMISC::DefaultMsgBoxDisplayer) \
+                        ignoreNextTime = NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime; \
+                if (NLMISC::DebugNeedAssert) \
+                        NLMISC_BREAKPOINT; \
+        } \
+}

        void function(sint type)
+        {
+                // the \c type must be between 0 and 15.
+                nlassertex(type>=0&&type<=16, ("type was %d", type));
+                // it'll display something like "assertion failed line 10 of test.cpp: type>=&&type<=16, type was 423555463"
+        }
+ *
+

{ \ + static bool ignoreNextTime = false; \ + if (!ignoreNextTime && !(exp)) { \ + ignoreNextTime = true; \ + NLMISC::DebugNeedAssert = false; \ + NLMISC::createDebug (); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime = ignoreNextTime; \ + else \ + NLMISC::DebugNeedAssert = true; \ + NLMISC::AssertLog->setPosition (__LINE__, __FILE__); \ + NLMISC::AssertLog->displayNL ("\"%s\" ", #exp); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + ignoreNextTime = NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime; \ + if (NLMISC::DebugNeedAssert) \ + NLMISC_BREAKPOINT; \ + } \ +}

for (int i = 0; i < Vect.size(); i++) + { + // all string must not be NULL, but if it's happen, log only the first time. + nlassertonce(Vect[i].string!=NULL); + } + * +

void function(char *filename) + { + FILE *fp = fopen (filename, "r"); + if (fp==NULL) + { + nlerror("file not found"); + } + } + * +

{ \ + static bool ignoreNextTime = false; \ + if (!ignoreNextTime) { \ + NLMISC::DebugNeedAssert = false; \ + NLMISC::createDebug (); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime = ignoreNextTime; \ + else \ + NLMISC::DebugNeedAssert = true; \ + NLMISC::AssertLog->setPosition (__LINE__, __FILE__); \ + NLMISC::AssertLog->displayNL ("STOP"); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + ignoreNextTime = NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime; \ + if (NLMISC::DebugNeedAssert) \ + NLMISC_BREAKPOINT; \ + } \ +}

{ \ + static bool ignoreNextTime = false; \ + if (!ignoreNextTime) { \ + NLMISC::DebugNeedAssert = false; \ + NLMISC::createDebug (); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime = ignoreNextTime; \ + else \ + NLMISC::DebugNeedAssert = true; \ + NLMISC::AssertLog->setPosition (__LINE__, __FILE__); \ + NLMISC::AssertLog->display ("STOP "); \ + NLMISC::AssertLog->displayRawNL str; \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + ignoreNextTime = NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime; \ + if (NLMISC::DebugNeedAssert) \ + NLMISC_BREAKPOINT; \ + } \ +}

{ \ + static bool ignoreNextTime = false; \ + if (!ignoreNextTime) { \ + ignoreNextTime = true; \ + NLMISC::DebugNeedAssert = false; \ + NLMISC::createDebug (); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime = ignoreNextTime; \ + else \ + NLMISC::DebugNeedAssert = true; \ + NLMISC::AssertLog->setPosition (__LINE__, __FILE__); \ + NLMISC::AssertLog->displayNL ("STOP"); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + ignoreNextTime = NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime; \ + if (NLMISC::DebugNeedAssert) \ + NLMISC_BREAKPOINT; \ + } \ +}

// Load a file and assert if the load failed. This example will work \b only in debug mode because in release mode, + // nlassert do nothing, the the load function will not be called... + nlassert(load("test.tga")); + + // If you want to do that anyway, you could call nlverify. In release mode, the assertion will not be tested but + // the \c load function will be called. + nlverify(load("test.tga")); + + // You can also do this: + bool res = load ("test.tga")); + assert(res); + + * +

{ \ + static bool ignoreNextTime = false; \ + if (!ignoreNextTime && !(exp)) { \ + NLMISC::DebugNeedAssert = false; \ + NLMISC::createDebug (); \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime = ignoreNextTime; \ + else \ + NLMISC::DebugNeedAssert = true; \ + NLMISC::AssertLog->setPosition (__LINE__, __FILE__); \ + NLMISC::AssertLog->display ("\"%s\" ", #exp); \ + NLMISC::AssertLog->displayRawNL str; \ + if (NLMISC::DefaultMsgBoxDisplayer) \ + ignoreNextTime = NLMISC::DefaultMsgBoxDisplayer->IgnoreNextTime; \ + if (NLMISC::DebugNeedAssert) \ + NLMISC_BREAKPOINT; \ + } \ +}

void function(char *str) + { + // display the type value. + if (str==NULL) + { + nlwarning("in function(), str should not be NULL, assume it's an empty string"); + str=""; + } + } + * +

debug.h File Reference

Namespaces

Defines

Detailed Description

Define Documentation