cException.h

Go to the documentation of this file.

//
 
#ifndef _INC_cException_H
#define _INC_cException_H
#ifndef NO_PRAGMA_ONCE
#pragma once
#endif
 
#include "cExceptionBase.h"
#include "HResult.h"
#include "cObject.h"            // DECLARE_DYNAMIC()
#include "cString.h"
#include "cUnitTestDecl.h"
 
namespace Gray
{
        UNITTEST2_PREDEF(cException);
 
        typedef cStringT<LOGCHAR_t> cStringL;   
 
#if defined(_MSC_VER)
#pragma warning(disable:4275)   // non dll-interface class 'type_info' used as base for dll-interface class. http://msdn.microsoft.com/en-us/library/3tdb471s.aspx 
#endif
        class GRAYCORE_LINK cExceptionHolder : public cPtrFacade < cExceptionBase >
        {
 
        public:
                static const StrLen_t k_MSG_MAX_SIZE = 1024;    
 
        private:
                bool m_bDeleteEx;       
 
        public:
                cExceptionHolder() noexcept
                        : m_bDeleteEx(false)
                {
                }
                explicit cExceptionHolder(cExceptionBase* pEx, bool bDeleteEx = true) noexcept
                        : cPtrFacade<cExceptionBase>(pEx)
                        , m_bDeleteEx(bDeleteEx)
                {
                }
                explicit cExceptionHolder(cExceptionBase& ex) noexcept
                        : cPtrFacade<cExceptionBase>(&ex)
                        , m_bDeleteEx(false)
                {
                }
                ~cExceptionHolder() noexcept
                {
                        if (m_bDeleteEx && m_p != nullptr) // make sure DetachException() wasn't called.
                        {
#ifdef _MFC_VER // using _MFC_VER.
                                m_p->Delete();
#else
                                delete m_p;
#endif
                        }
                }
                void AttachException(cExceptionBase* pEx, bool bDeleteEx)
                {
                        ASSERT(m_p == nullptr);
                        m_p = pEx;
                        m_bDeleteEx = bDeleteEx;
                }
                cException* get_Ex() const;     // is Custom?
 
                BOOL GetErrorMessage(LOGCHAR_t* lpszError, StrLen_t nLenMaxError = k_MSG_MAX_SIZE) const;
                cStringL get_ErrorStr() const;
                LOGLEV_TYPE get_Severity() const;
        };
 
        class GRAYCORE_LINK cException : public cExceptionBase
        {
 
        public:
                const LOGLEV_TYPE m_eSeverity;          
                const LOGCHAR_t* m_pszDescription;      
                static const LOGCHAR_t* k_szDescriptionDefault;
 
        public:
                cException(const LOGCHAR_t* pszDescription, LOGLEV_TYPE eLogLevel = LOGLEV_ERROR) noexcept
                        : m_eSeverity(eLogLevel)
#if ! defined(_MFC_VER) && defined(_MSC_VER) && ! defined(UNDER_CE) // not using _MFC_VER.
                        , cExceptionBase(pszDescription)
#endif
                        , m_pszDescription((pszDescription == nullptr) ? k_szDescriptionDefault : pszDescription)
                {
                }
                virtual ~cException() THROW_DEF
                {
                }
                LOGLEV_TYPE get_Severity() const noexcept
                {
                        return m_eSeverity;
                }
 
                DECLARE_DYNAMIC(cException);    // For MFC support.
 
                virtual BOOL GetErrorMessage(GChar_t* lpszError, UINT nLenMaxError = cExceptionHolder::k_MSG_MAX_SIZE, UINT* pnHelpContext = nullptr);
                cStringL get_ErrorStr(); // similar to STL what()
 
#ifndef _MFC_VER        // using _MFC_VER.
                virtual const char* what() const THROW_DEF
                {
                        return m_pszDescription;
                }
#endif // ! _MFC_VER
 
                UNITTEST_FRIEND(cException);
        };
 
        class GRAYCORE_LINK cExceptionHResult : public cException
        {
                typedef cException SUPER_t;
 
        public:
                HRESULT m_hResultCode;  
 
        public:
                cExceptionHResult(HRESULT hResultCode = E_FAIL, const LOGCHAR_t* pszDescription = nullptr, LOGLEV_TYPE eSeverity = LOGLEV_ERROR) THROW_DEF
                        : cException(pszDescription, eSeverity)
                        , m_hResultCode(hResultCode)
                {
                }
                virtual ~cExceptionHResult() THROW_DEF
                {
                }
                HRESULT get_HResultCode() const noexcept
                {
                        return m_hResultCode;
                }
                virtual BOOL GetErrorMessage(GChar_t* lpszError, UINT nLenMaxError, UINT* pnHelpContext) override;
        };
};
 
#endif // _INC_cException_H