MkExceptionC_RB_API

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

Collaboration diagram for MkExceptionC_RB_API:

Functions
void	rbmkkernel_MkExceptionC_Raise (OT_Prefix_ARGS MK_MNGN const expobj, MK_STRN const doc, MK_STRN const callfunc, MK_I32 callline)
	convert an MkErrorC into a Target-Programming-Language (TPL) exception …
MK_ERR	rbmkkernel_MkExceptionC_Catch (OT_Prefix_ARGS MK_MNG const expobj, MK_EXP exception, MK_STRN const callfunc, MK_STRN const stop)
	convert an Target-Programming-Language (TPL) exception into an MkErrorC …

Detailed Description

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.

Function Documentation

rbmkkernel_MkExceptionC_Catch()

MK_ERR rbmkkernel_MkExceptionC_Catch	(	OT_Prefix_ARGS MK_MNG const	expobj,
		MK_EXP	exception,
		MK_STRN const	callfunc,
		MK_STRN const	stop )

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 Ruby, if nil the global exception object is used
[in]	callfunc	a user-defined postfix to identify the calling-function or the environment (default = name-of-function, nil = resolve-own-name)

Returns

the MkErrorC created with data from exception

Parameters

[in]

stop

End of stack-trace

Definition at line 66 of file MkExceptionC_rb.c.

  {
  if (exception == NULL) exception = (MK_EXP) rb_errinfo();
  VALUE ex = (VALUE) exception;
  MK_ERR err = MkErrorFORMAT_1M(expobj);
  if (rb_obj_is_kind_of(ex, MK(MkExceptionC)) == Qtrue) {
    static ID id_mkerr = 0;
    if (!id_mkerr) id_mkerr = rb_intern("mkerr");
    MK_ERR newerr = VAL2ERR(rb_funcallv(ex,id_mkerr,0,NULL));
    MkErrorSetE (err, newerr);
    rb_set_errinfo(Qnil);
  } else if (rb_obj_is_kind_of(ex, rb_eStandardError) == Qtrue) {
 
    VALUE argv[4];
      argv[0] = OT_TMP_ERR_OBJ(err);
      argv[1] = ex;
      argv[2] = STRN2VAL(callfunc);
      argv[3] = stop == NULL ? Qnil : STRN2VAL(stop);
 
    rb_funcallv(MK(MkExceptionC), MK(id_Catch), 4, argv);
    rb_set_errinfo(Qnil);
  } else if (rb_obj_is_kind_of(ex, rb_eSystemExit) == Qtrue) {
    // exit in an callback
    MkErrorSetEXIT(err,callfunc);
  } else {
    MkLogV_2X(err,"WARNING: re-raise exception (long-jump in code) → %s\n", 
      VAL2STRN(rb_inspect(ex))
    );
    rb_exc_raise(ex);
  }
  return err;
}

rbmkkernel_MkExceptionC_Raise()

void rbmkkernel_MkExceptionC_Raise	(	OT_Prefix_ARGS MK_MNGN const	expobj,
		MK_STRN const	doc,
		MK_STRN const	callfunc,
		MK_I32	callline )

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, nil = resolve-own-name)
[in]	callline	the number of the line the call take place (e.g. LINE)
[in]	doc	documentation string

Definition at line 43 of file MkExceptionC_rb.c.

  {
  MK_ERR err = MkErrorFORMAT_1M(expobj);
  MkErrorStackFormat(err,doc,callfunc,callline);
  MK(Get_Call_Stack)(MK_RT_CALL err, 0);
  MK_ERR newerr = MkErrCheck(expobj) && expobj != err ? (MK_ERR)expobj : MkErrorDup(err);
  //VALUE errO = Data_Wrap_Struct(MK(MkExceptionC), NULL, MK(MkExceptionC_Delete), newerr);
  VALUE args[2];
  args[0] = OT_TMP_ERR_OBJ(newerr);
  args[1] = STRN2VAL(MkErrorGetTextI(newerr));
  VALUE errO = rb_class_new_instance(2,args,MK(MkExceptionC));
  MkErrorReset_1(err);
  rb_exc_raise(errO);
  MK_UNREACHABLE;
}