nevrax.org : docs

debug.h File Reference

More...

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