OGRE  13.6
Object-Oriented Graphics Rendering Engine
OgreException.h File Reference
#include "OgrePrerequisites.h"
#include "OgreString.h"
#include <exception>
#include "OgreHeaderPrefix.h"
#include "OgreHeaderSuffix.h"

Classes

class  Ogre::Exception
 When thrown, provides information about an error that has occurred inside the engine. More...
 
class  Ogre::ExceptionFactory
 Class implementing dispatch methods in order to construct by-value exceptions of a derived type based just on an exception code. More...
 
class  Ogre::FileNotFoundException
 
class  Ogre::InternalErrorException
 
class  Ogre::InvalidCallException
 
class  Ogre::InvalidParametersException
 
class  Ogre::InvalidStateException
 
class  Ogre::IOException
 
class  Ogre::ItemIdentityException
 
class  Ogre::RenderingAPIException
 
class  Ogre::RuntimeAssertionException
 
class  Ogre::UnimplementedException
 Template struct which creates a distinct type for each exception code. More...
 

Namespaces

 Ogre
 

Macros

#define OGRE_EXCEPT(...)   OGRE_EXPAND(OGRE_EXCEPT_CHOOSER(__VA_ARGS__, OGRE_EXCEPT_3, OGRE_EXCEPT_2)(__VA_ARGS__))
 
#define OGRE_EXCEPT_2(code, desc)   Ogre::ExceptionFactory::throwException(code, desc, __FUNCTION__, __FILE__, __LINE__)
 
#define OGRE_EXCEPT_3(code, desc, src)   Ogre::ExceptionFactory::throwException(code, desc, src, __FILE__, __LINE__)
 
#define OGRE_EXCEPT_CHOOSER(arg1, arg2, arg3, arg4, ...)   arg4
 
#define OGRE_EXPAND(x)   x
 
#define OgreAssert(expr, mesg)   assert( (expr) && (mesg) )
 Checks a condition at runtime and throws exception/ aborts if it fails. More...
 
#define OgreAssertDbg(expr, mesg)
 replaced with OgreAssert(expr, mesg) in Debug configuration More...
 

Macro Definition Documentation

◆ OgreAssert

#define OgreAssert (   expr,
  mesg 
)    assert( (expr) && (mesg) )

Checks a condition at runtime and throws exception/ aborts if it fails.

The macros OgreAssert (and OgreAssertDbg) evaluate the specified expression. If it is 0, OgreAssert raises an error (see Ogre::RuntimeAssertionException) in Release configuration and aborts in Debug configuration. The macro OgreAssert checks the condition in both Debug and Release configurations while OgreAssertDbg is only retained in the Debug configuration.

To always abort instead of throwing an exception or disabling OgreAssert in Release configuration altogether, set OGRE_ASSERT_MODE in CMake accordingly.

◆ OgreAssertDbg

#define OgreAssertDbg (   expr,
  mesg 
)

replaced with OgreAssert(expr, mesg) in Debug configuration