csmkkernel.MkExceptionC Class Reference

C-API: MkExceptionC_C_API - MkExceptionC - The default-exception of the Programming-Language-Micro-Kernel (PLMK) … More...

Inheritance diagram for csmkkernel.MkExceptionC:

Collaboration diagram for csmkkernel.MkExceptionC:

Public Member Functions
	MkExceptionC (IntPtr expobj, [CallerMemberName] string callfunc=null, [CallerLineNumber] int callline=-1)
	convert an MkErrorC into a Target-Programming-Language (TPL) exception …
	MkExceptionC (SerializationInfo info, StreamingContext sctx)
override void	GetObjectData (SerializationInfo info, StreamingContext sctx)

Static Public Member Functions
static IntPtr	Catch (IntPtr mkrt, IntPtr expobj, Exception exception, IntPtr callfunc)
	convert an Target-Programming-Language (TPL) exception into an MkErrorC …

Detailed Description

C-API: MkExceptionC_C_API - 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 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.

Definition at line 28 of file MkExceptionC.cs.

Constructor & Destructor Documentation

MkExceptionC() [1/2]

csmkkernel.MkExceptionC.MkExceptionC ( IntPtr expobj, [CallerMemberName] string callfunc = null, [CallerLineNumber] int callline = -1 )

inline

convert an MkErrorC into a Target-Programming-Language (TPL) exception …

Parameters

[in]	expobj	The LibMsgqueObject used to personalize the exception/error (will be validated first)
[in]	callfunc	a user-defined postfix to identify the calling-function or the environment (default = name-of-function, null = resolve-own-name)
[in]	callline	the number of the line the call take place (e.g. LINE)

Definition at line 39 of file MkExceptionC.cs.

      : base(Marshal.PtrToStringAnsi(Mk.MkErrorGetText(Mk.MkErrorFORMAT(expobj)))) {
      IntPtr def = Mk.MkErrorFORMAT(expobj);
      IntPtr err = Mk.MkErr(expobj);
      IntPtr rt = Mk.MkRuntimeGetFromObj(err);
      hdl = err != IntPtr.Zero  && err != def ? err : Mk.MkErrorDup(rt,def);
      mkrt = rt;
      MkErrorC.StackFull(rt,hdl);
      Mk.MkRefIncr(hdl);
      IntPtr callfunc_cstr = Marshal.StringToHGlobalAnsi(callfunc);
      Mk.MkErrorReset(rt,def,callfunc_cstr,callline,false);
      Marshal.FreeHGlobal(callfunc_cstr);
    }

MkExceptionC() [2/2]

csmkkernel.MkExceptionC.MkExceptionC ( SerializationInfo info, StreamingContext sctx )

inline

Definition at line 56 of file MkExceptionC.cs.

                                                                       {
      hdl = (IntPtr)    info.GetValue("hdl",  typeof(IntPtr));
    }

Member Function Documentation

Catch()

static IntPtr csmkkernel.MkExceptionC.Catch ( IntPtr mkrt, IntPtr expobj, Exception exception, IntPtr callfunc )

inlinestatic

convert an Target-Programming-Language (TPL) exception into an MkErrorC …

Parameters

[in]	expobj	The LibMsgqueObject used to personalize the exception/error (will be validated first)
[in]	exception	the exception object from C#, if null the global exception object is used
[in]	callfunc	a user-defined postfix to identify the calling-function or the environment (default = name-of-function, null = resolve-own-name)

Returns

the MkErrorC created with data from exception

Parameters

[in]

mkrt

the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)

Definition at line 72 of file MkExceptionC.cs.

      { 
      IntPtr err = Mk.MkErrorFORMAT(expobj);
 
      // The exception that is thrown by methods invoked through reflection.
      if (exception is TargetInvocationException) exception = exception.InnerException;
      if (exception is MkExceptionC) {
//Console.Error.WriteLine($">>>>>\n{exception}\n<<<<<");
        MkExceptionC mqex = (MkExceptionC) exception;
        Mk.MkErrorSetE (mkrt,err, mqex.hdl);
      } else {
//Console.Error.WriteLine("exception=" + exception);
        IntPtr message_cstr = Marshal.StringToHGlobalAnsi($"{exception.GetType().FullName}: {exception.Message}");
        Mk.MkErrorSetC (mkrt,err, message_cstr, callfunc, -1);
        Marshal.FreeHGlobal(message_cstr);
        var st = new System.Diagnostics.StackTrace(exception, true);
 
        foreach (var sf in st.GetFrames()) {   
          if (!StackFrameExtensions.HasMethod(sf)) continue;
//Console.Error.WriteLine("sf=" + sf);
          var meth = sf.GetMethod();
          string fn;
          int ln;
          if (StackFrameExtensions.HasSource(sf)) {
            fn = sf.GetFileName();
            ln = sf.GetFileLineNumber();
          } else {
            fn = meth.DeclaringType.Module.Name;
            ln = -1;
          }
          MkErrorC.Stack(mkrt,err,meth.ToString(), fn, ln);
          if (meth.Name == "ServiceCall") break;
        }
      }
      return err;
    }

GetObjectData()

override void csmkkernel.MkExceptionC.GetObjectData ( SerializationInfo info, StreamingContext sctx )

inline

Definition at line 65 of file MkExceptionC.cs.

                                                                                      {
      info.AddValue("hdl", hdl);
      base.GetObjectData (info, sctx);
    }

---

The documentation for this class was generated from the following file:

• MkExceptionC.cs