SoCatch.h

Go to the documentation of this file.

// **InsertLicense** code
 
#ifndef  _SO_CATCH_
#define  _SO_CATCH_
 
#include <Inventor/system/SbSystem.h>
#include <Inventor/misc/SoBasic.h>
#include <Inventor/SbString.h>
#include <Inventor/errors/SoError.h>
 
 
class INVENTOR_API SoCatch
{
   public:
 
      static bool isExceptionHandlingEnabled();
 
      static void enableExceptionHandling(bool on);
 
      static void initClass();
 
      static void postExceptionMessage(SoType      ERR_OBJ_TYPE_ID,
                                       const char *OP_DESCR_STR,
                                       SoType      ACTION_TYPE_ID,
                                       const char *END_STR);
 
   private:
 
      static bool _isExceptionHandlingEnabled;
 
};
 
#if !defined(DISABLE_ERRORTRACING)
 
#define SO_CATCH_START \
    if (!SoCatch::isExceptionHandlingEnabled()) {
 
 
#define SO_CATCH_ELSE(CODE_BEFORE_TRY) \
    }                                  \
    else {                             \
      CODE_BEFORE_TRY                  \
      try {
 
 
#define SO_CATCH_END(ERR_OBJ_TYPE_ID, OP_DESCR_STR, ACTION_TYPE_ID, END_STR)    \
      }                                                       \
      catch(...) {                                            \
        /* Bad case, we caught a crash. Compose            */ \
        /* the error string and post it to SoError.        */ \
        try {                                                 \
          /* Do extra save message posting since we must   */ \
          /* assume that passed parameters (which could    */ \
          /* be expressions) also could be corrupt.        */ \
          SoCatch::postExceptionMessage(ERR_OBJ_TYPE_ID,      \
                                        OP_DESCR_STR,         \
                                        ACTION_TYPE_ID,       \
                                        END_STR);             \
        }                                                     \
        catch(...) {                                          \
          SoError::post("<Could not create error message "    \
                        "after catching fatal error>");       \
        }                                                     \
      } /* catch(...) */                                      \
    } /* else of SO_CATCH_ELSE */
 
#else  // DISABLE_ERRORTRACING
 
#define SO_CATCH_START \
    if(1) {
#define SO_CATCH_ELSE(CODE_BEFORE_TRY) \
    }                                  \
    else {
#define SO_CATCH_END(ERR_OBJ_TYPE_ID, OP_DESCR_STR, ACTION_TYPE_ID, END_STR) \
    }
 
#endif  // DISABLE_ERRORTRACING
 
#endif  // _SO_CATCH_