vlExceptions.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 1992-2025 MAK Technologies, Inc
** All rights reserved.
*******************************************************************************/
#pragma once

#include "vlMachineTypes.h"
#include <exception>
#include "vlString.h"
#include "vlFilename.h"
#include <iosfwd>


#ifdef DtUSE_UTILITIES_NAMESPACE
namespace DtUSE_UTILITIES_NAMESPACE
{
#endif


class DT_DLL_VLUTIL DtException
{
public:

   DtException(const char *errorMessage, 
      const DtException *previousException = 0) throw() ;

   DtException(const char *errorMessage, 
      const char *functionName, 
      const char *fileName, 
      unsigned int lineNumber,
      const DtException *previousException = 0) throw();

   DtException(const DtException& other) throw();

   DtException& operator=(const DtException& other) throw();

   virtual~DtException() throw();

   virtual const DtException *lastException() const throw();

   virtual const DtException& initialException() const throw();

   virtual const char* message() const throw();

   virtual DtString what() const throw();

   virtual DtString where() const throw();
   
protected:
   DtString myLocationMessage;
   DtString myErrorMessage;
   DtException *myChainedException;

};

template <int I>
class DtTemplatedException: public DtException
{
public:

   DtTemplatedException(const char *errorMessage, 
      const DtException *previousException = 0) throw():
   DtException(errorMessage, previousException){}

   DtTemplatedException(const char *errorMessage, 
      const char *functionName, 
      const char *fileName, 
      unsigned int lineNumber,
      const DtException *previousException = 0) throw():
   DtException(errorMessage, functionName, fileName, lineNumber, previousException){}

   DtTemplatedException(const DtTemplatedException& other) throw() : DtException(other) 
   {}

   DtTemplatedException& operator=(const DtTemplatedException& other) throw() 
   {DtException::operator=(other); }

   virtual ~DtTemplatedException() throw(){}

private:
   int retVal() const { return I;}
};

const int DtInvalidInputNumber = ~0;

typedef DtTemplatedException<DtInvalidInputNumber> DtInvalidInput;

const int DtUnknownExceptionNumber = ~1;

typedef DtTemplatedException<DtUnknownExceptionNumber> DtUnknownException;

const int DtCorruptedStateNumber = ~2;

typedef DtTemplatedException<DtCorruptedStateNumber> DtCorruptedState;

#ifndef __DtFUNC__
#if defined(__GNUC__) 
#define __DtFUNC__ __PRETTY_FUNCTION__
#elif defined(_WIN32) && (_MSC_VER != 1200)
#define __DtFUNC__ __FUNCSIG__
#else
#define __DtFUNC__ "-Unknown Function-"
#endif
#endif /* __DtFUNC__ */

#define DtTHROW_NEW(exceptionClass,errorMsg) \
   throw exceptionClass(DtString(#exceptionClass": ") + errorMsg, __DtFUNC__, DtFilename::stripPath(__FILE__), __LINE__, 0)

#define DtTHROW_PROPAGATE(exceptionClass, errorMsg, exPtr) \
   throw exceptionClass(DtString(#exceptionClass": ") + errorMsg, __DtFUNC__, DtFilename::stripPath(__FILE__), __LINE__, exPtr)

#define DtCATCH_AND_PROPAGATE(exceptionClass) \
   catch( DtException &ex) \
{\
   throw exceptionClass("Propagating DtException.", __DtFUNC__, DtFilename::stripPath(__FILE__), __LINE__, &ex);\
}\
   catch(std::exception &sexception)\
{\
   DtString error("std::exception ");\
   error += sexception.what();\
   throw exceptionClass(error.c_str(), __DtFUNC__, DtFilename::stripPath(__FILE__), __LINE__, 0); \
}\
   catch(...)\
{\
   throw DtUnknownException("Caught Unknown Exception.", __DtFUNC__, DtFilename::stripPath(__FILE__), __LINE__, 0);\
}

#define DtCATCH_AND_WARN(stream) \
   catch (DtException &ex) \
{ \
   stream << "Caught DtException with stack: \n" << ex << std::endl; \
} \
   catch (std::exception &sexception) \
{\
   stream << "Caught std::exception: " << sexception.what() << std::endl; \
}\
   catch (...) \
{ \
   stream << "Caught Unknown Exception in. " << __DtFUNC__ << "[" << DtFilename::stripPath(__FILE__) << ":"  \
   << __LINE__ << "]" << std::endl; \
}

#define DtPROPAGATE(functionBody)\
{ try\
  functionBody\
  DtCATCH_AND_PROPAGATE(DtCorruptedState)\
} 

DT_DLL_VLUTIL std::ostream & operator << (std::ostream &, const DtException &);


#ifdef DtUSE_UTILITIES_NAMESPACE
} 
#endif