MkExceptionC_CC_API

MkExceptionC - the final class to connect the MkErrorC with the C++ error … More...

Collaboration diagram for MkExceptionC_CC_API:

Classes
class	ccmkkernel::MkExceptionC
	MkExceptionC - The default-exception of the Programming-Language-Micro-Kernel (PLMK) … More...

Functions
	ccmkkernel::MkExceptionC::MkExceptionC (MK_ERR err, MK_STRN const caller, MK_I32 const line)
	constructor
	ccmkkernel::MkExceptionC::MkExceptionC (MK_MNGN const mng, MK_STRN const caller, MK_I32 const line)
	constructor
	ccmkkernel::MkExceptionC::MkExceptionC (const MkExceptionC &e)
	copy constructor
virtual	ccmkkernel::MkExceptionC::~MkExceptionC () throw ()
	destructor
virtual MK_STRN	ccmkkernel::MkExceptionC::what () const throw ()
	Returns the explanatory string.
void	ccmkkernel::MkExceptionC::Log (MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION(), MK_I32 lvl=0) const
	log the error to MkLogFileC (default: stderr) … → C-API: ErrorLog
static void	ccmkkernel::MkExceptionC::Raise (MK_MNGN const expobj, MK_STRN const callfunc=__builtin_FUNCTION(), MK_I32 const callline=__builtin_LINE())
	convert an MkErrorC into a Target-Programming-Language (TPL) exception … → C-API: libmkkernel::MkExceptionRaise
static MK_ERR	ccmkkernel::MkExceptionC::Catch (MK_MNGN const expobj, std::exception const *exception, MK_STRN const callfunc=__builtin_FUNCTION())
	convert an Target-Programming-Language (TPL) exception into an MkErrorC … → C-API: libmkkernel::MkExceptionCatch
static MK_ERR	ccmkkernel::MkExceptionC::Catch (MK_MNGN const expobj, std::exception const &exception, MK_STRN const callfunc=__builtin_FUNCTION())
	convert an Target-Programming-Language (TPL) exception into an MkErrorC … → C-API: libmkkernel::MkExceptionCatch
static MK_ERR	ccmkkernel::MkExceptionC::Catch (MK_MNGN const expobj, const std::string &msg, MK_STRN const callfunc=__builtin_FUNCTION())
	convert an Target-Programming-Language (TPL) exception into an MkErrorC … → C-API: libmkkernel::MkExceptionCatch

Variables
MK_ERR	ccmkkernel::MkExceptionC::hdl
	link to the MkErrorC object

Detailed Description

MkExceptionC - the final class to connect the MkErrorC with the C++ error …

MkExceptionC - The default-exception of the Programming-Language-Micro-Kernel (PLMK) …

The Programming-Language-Micro-Kernel (PLMK) provide with MkErrorC a complete error-handling with focus to support the "C" Programming-Language. The support include catch, raise, signal and attributes. In addition every Target-Programming-Language (TPL) add their own error-handling and the purpose of MkExceptionC is to integrate the MkErrorC into the Target-Programming-Language (TPL).

The default-exception MkExceptionC is used to connect the MkErrorC with the Target-Programming-Language (TPL) error-object.

• The default-error is defined in MkRuntimeS::error_mk.
• On error the default-error is set to the error-data, the MkErrorE status change to libmkkernel::MK_ERROR.
• The non-C language create a copy from the default-error and throw the copy as MkExceptionC exception.
• The C language just return the MkErrorE status of the default-error.

The implementation of an exception depends heavily on the Target-Programming-Language (TPL), starting with no exception at all, for example. C, an exception as a class object, or as an exception as a global attribute.

Attention

• All MkExceptionC code is implemented at the Target-Programming-Language (TPL) without support by the Programming-Language-Micro-Kernel (PLMK) compiler.
• By default, MkExceptionC is only used internally, hidden by the class MkErrorC.

Function Documentation

Catch() [1/3]

MK_ERR ccmkkernel::MkExceptionC::Catch ( MK_MNGN const expobj, const std::string & msg, MK_STRN const callfunc = __builtin_FUNCTION() )

static

convert an Target-Programming-Language (TPL) exception into an MkErrorC … → C-API: libmkkernel::MkExceptionCatch

Definition at line 87 of file MkExceptionC_cc.cc.

    {
      MK_ERR err = MkErrorFORMAT_1M(mng);
      MkRtSetup_XN(err);
 
      MkErrorSetC (err, msg.c_str(), caller, -1);
 
      return err;
    }

Catch() [2/3]

static MK_ERR ccmkkernel::MkExceptionC::Catch ( MK_MNGN const expobj, std::exception const & exception, MK_STRN const callfunc = __builtin_FUNCTION() )

inlinestatic

convert an Target-Programming-Language (TPL) exception into an MkErrorC … → C-API: libmkkernel::MkExceptionCatch

Definition at line 88 of file MkExceptionC_cc.hh.

        {
        return Catch(expobj, &exception, callfunc);
      }

Catch() [3/3]

MK_ERR ccmkkernel::MkExceptionC::Catch ( MK_MNGN const expobj, std::exception const * exception, MK_STRN const callfunc = __builtin_FUNCTION() )

static

convert an Target-Programming-Language (TPL) exception into an MkErrorC … → C-API: libmkkernel::MkExceptionCatch

Definition at line 65 of file MkExceptionC_cc.cc.

    {
      std::stringstream ss;
      MK_ERR err = MkErrorFORMAT_1M(mng);
      MkRtSetup_XN(err);
 
      auto* mqex = dynamic_cast<MkExceptionC const * const>(ex);
        if (mqex != NULL) { 
          MkErrorSetE (err, mqex->hdl); 
          return err ; 
        }
      auto* krex = dynamic_cast<MkKernelException const * const>(ex);
        if (krex != NULL) {
          MkErrorSetC (err, ex->what(), caller, -1);
          MkErrorStackFormat (err, krex->func.c_str(), krex->file.c_str(), krex->line);
          return err ; 
        }
 
      MkErrorSetC (err, ex->what(), caller, -1);
      return err;
    }

Here is the caller graph for this function:

Log()

void ccmkkernel::MkExceptionC::Log ( MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0 ) const

inline

log the error to MkLogFileC (default: stderr) … → C-API: ErrorLog

Definition at line 63 of file MkExceptionC_cc.hh.

              {
        MkRtSetup_X(hdl);
        MkErrorLog(hdl, NULL, debug, callfunc, lvl);
      }

MkExceptionC() [1/3]

ccmkkernel::MkExceptionC::MkExceptionC

(

const MkExceptionC &

e

)

copy constructor

Definition at line 32 of file MkExceptionC_cc.cc.

                                                    {
      hdl = e.hdl;
      MkRefIncr_1X(hdl);
    }

MkExceptionC() [2/3]

ccmkkernel::MkExceptionC::MkExceptionC ( MK_ERR err, MK_STRN const caller, MK_I32 const line )

protected

constructor

Definition at line 42 of file MkExceptionC_cc.cc.

                                                                                        {
      MK_ERR const def = MkErrorFORMAT_1M(err);
      MkRtSetup_XN(def);
      hdl = (err && err != def ? err : MkErrorDup(def));
 
      MkRefIncr_1X(hdl);
      MkErrorReset(def,caller,line,false);
    }

Here is the caller graph for this function:

MkExceptionC() [3/3]

ccmkkernel::MkExceptionC::MkExceptionC ( MK_MNGN const mng, MK_STRN const caller, MK_I32 const line )

protected

constructor

Definition at line 51 of file MkExceptionC_cc.cc.

                                                                                         {
      MK_ERR const def = MkErrorFORMAT_1M(mng);
      MkRtSetup_XN(def);
      hdl = MkErrorDup(def);
 
      MkRefIncr_1X(hdl);
      MkErrorReset(def,caller,line,false);
    }

Raise()

void ccmkkernel::MkExceptionC::Raise ( MK_MNGN const expobj, MK_STRN const callfunc = __builtin_FUNCTION(), MK_I32 const callline = __builtin_LINE() )

static

convert an MkErrorC into a Target-Programming-Language (TPL) exception … → C-API: libmkkernel::MkExceptionRaise

Definition at line 60 of file MkExceptionC_cc.cc.

    {
      throw MkExceptionC(mng,caller,line);
    }

Here is the caller graph for this function:

what()

virtual MK_STRN ccmkkernel::MkExceptionC::what ( ) const throw (  )

inlinevirtual

Returns the explanatory string.

Returns

Pointer to a null-terminated string with explanatory information. The pointer is guaranteed to be valid at least until the exception object from which it is obtained is destroyed, or until a non-const member function on the exception object is called.

Definition at line 58 of file MkExceptionC_cc.hh.

                                                  {
        return MkBUF_R(&hdl->text).storage.first.C;
      }

~MkExceptionC()

ccmkkernel::MkExceptionC::~MkExceptionC ( ) throw (  )

virtual

destructor

Definition at line 37 of file MkExceptionC_cc.cc.

                                {
      MkRtSetup_X(hdl);
      MkRefDecr_X(hdl);
    }

Variable Documentation

hdl

MK_ERR ccmkkernel::MkExceptionC::hdl

protected

link to the MkErrorC object

Definition at line 38 of file MkExceptionC_cc.hh.