MkObjectC_C_API

MkObjectC - class known as obj or object is used as base-class type for a Programming-Language-Micro-Kernel (PLMK) class … More...

Collaboration diagram for MkObjectC_C_API:

Topics
	MkObjectC_Class_C_API
	MkObjectC - define the class …
	MkObjectC_TOR_C_API
	MkObjectC - create and destroy a managed-object …
	MkObjectC_Obj_C_API
	MkObjectC - managed-object details
	MkObjectC_Misc_C_API
	MkObjectC - various functions related to the MkObjectS …
	MkObjectC_Log_C_API
	MkObjectC - log information to MkLogFileC (default: stderr) …
	MkObjectC_Dbg_C_API
	MkObjectC - log a debugging-message to the MkLogFileC (default: stderr) …
	MkObjectC_Sys_C_API
	MkObjectC - L)anguage A)bstraction L)ayer definition …

Classes
struct	MkObjectProtectS
	the protect is used to "protect" data set by pAllocCreate if the new object is later initialized with a type specific object-initialization … More...
struct	MkObjectS
	object header … More...
struct	MkAllocDefS
	define the storage-allocator function More...

Macros
#define	MK_NULL_SIGNATURE   0
	signature used to mark an invalid signature …
#define	MkDbgObjInstancesO_2(o, c)
#define	MkDbgObjInstancesX_2(x, c)
#define	MkDbgObjInstancesX(x)
#define	MkDbgObjInstancesO(o)
#define	MkDbgDeepWriter(...)
#define	MkDbgDeepX_4(m, ident, func, fmt, ...)
#define	MkDbgDeepX_3(m, ident, fmt, ...)
#define	MkDbgDeepX_2(m, ident)

MkObjectC slot definition
typedef MK_OBJ(*	MkConstructorF) (MK_RT mkrt, MK_TYP type, MK_PTR nat, MK_PTR lnk)
typedef void(*	MkDestructorF) (MK_RT mkrt, MK_OBJ const obj)
typedef MK_OBJ(*	MkDupF) (MK_RT mkrt, MK_OBJN const obj)
typedef MK_OBJ(*	MkDup2F) (MK_RT mkrt, MK_OBJN const obj, MK_STRN const ident)
typedef MK_OBJ(*	MkMergeF) (MK_RT mkrt, MK_OBJ const obj)
typedef MK_OBJ(*	MkCopyF) (MK_RT mkrt, MK_OBJ const obj, MK_OBJN const src)
typedef MK_OBJ(*	MkResetF) (MK_RT mkrt, MK_OBJ const obj)
typedef MK_PTR(*	MkSelfCreateF) (MK_RT mkrt, MK_OBJ const obj, MK_PTR const env)
typedef void(*	MkSelfDeleteF) (MK_RT mkrt, MK_PTR self, MK_PTR const env)
typedef void(*	MkSelfUnlinkF) (MK_RT mkrt, MK_PTR self, MK_PTR const env)
typedef void(*	MkLogF) (MK_RT mkrt, MK_OBJN const obj, MK_OBJN fmt, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)
typedef MK_STRN(*	MkToStringF) (MK_RT mkrt, MK_OBJN const obj)
typedef MK_PTR(*	MkAllocCreateFLT) (MK_RT mkrt, MK_TYP const type)
typedef void(*	MkAllocDeleteF) (MK_RT mkrt, MK_TYP const type, MK_PTR ptr)
typedef void(*	MkTypeInitF) (MK_RT mkrt, MK_TYP const type)
typedef bool(*	MkLogFormatF) (MK_RT mkrt, char *header, MK_SIZE const headerSize, MK_OBJN const obj, MK_STRN const caller, MK_I32 const debug, MK_STRN const fmt)

MkObjectC type check
#define	__MkCheckTO(t, o)
#define	_MkCheckTO(t, o)
#define	__MkCheckO(cls, o)
#define	_MkCheckO(cls, o)
#define	__MkCheckX(cls, x)
#define	_MkCheckX(cls, x)
#define	__MkCheckM(cls, m)
#define	_MkCheckM(cls, m)
#define	MkCheckNN(cls, x)
#define	MkSanitizeCheck(_root, _m)
#define	MkSanitizeCheckO(_root, _o)
#define	MkAssertO(cls, o)
#define	MkAssertX(cls, x)
#define	MkAssertCastM(cls, m)
	}
#define	toTT(_type)

Detailed Description

MkObjectC - class known as obj or object is used as base-class type for a Programming-Language-Micro-Kernel (PLMK) class …

jvmkkernel is also called as Programming-Language-Micro-Kernel (PLMK). jvmkkernel is like a programming-language without syntax but using the Target-Programming-Language (in our case Java) of the Micro-Kernel as runtime environment.

Integration

To operate as a Micro-Kernel a maximum integration into the Target-Programming-Language is available.

This integration is done using the managed-object-technology.

Managed-Object

A managed-object is a piece of C-Code able to act as a native datatype in all Target-Programming-Languages supported.

The managed object supports low level integration features descripted in MkObjectS :

• object identification based on signatures
• reference counting
• management of the self object pointer for the target-language
• object-type specific features provided with MkTypeS

In the implementation-layer of jvmkkernel only the public-features of the MkObjectC are visible to the programmer.

See also

For the full documentation read: Managed-Object

Macro Definition Documentation

__MkCheckM

#define __MkCheckM	(		cls,
			m )

Value:

__MkCheckO(cls,((MK_OBJ)(m)))

Definition at line 3299 of file LibMkKernel_mk.h.

__MkCheckO

#define __MkCheckO	(		cls,
			o )

Value:

(((*o).signature              & cls##_MASK) == cls##_SIGNATURE)

Definition at line 3295 of file LibMkKernel_mk.h.

__MkCheckTO

#define __MkCheckTO	(		t,
			o )

Value:

(((*o).signature              & (*t).objmask) == (*t).objsig)

Definition at line 3293 of file LibMkKernel_mk.h.

__MkCheckX

#define __MkCheckX	(		cls,
			x )

Value:

__MkCheckO(cls,(cls##_X2obj(x)))

Definition at line 3297 of file LibMkKernel_mk.h.

_MkCheckM

#define _MkCheckM	(		cls,
			m )

Value:

((m) && __MkCheckM(cls,m))

Definition at line 3300 of file LibMkKernel_mk.h.

_MkCheckO

#define _MkCheckO	(		cls,
			o )

Value:

((o) && __MkCheckO(cls,(o)))

Definition at line 3296 of file LibMkKernel_mk.h.

_MkCheckTO

#define _MkCheckTO	(		t,
			o )

Value:

((o) && __MkCheckTO((t),(o)))

Definition at line 3294 of file LibMkKernel_mk.h.

_MkCheckX

#define _MkCheckX	(		cls,
			x )

Value:

((x) && __MkCheckO(cls,(cls##_X2obj(x))))

Definition at line 3298 of file LibMkKernel_mk.h.

MK_NULL_SIGNATURE

#define MK_NULL_SIGNATURE   0

signature used to mark an invalid signature …

Definition at line 3331 of file LibMkKernel_mk.h.

MkAssertCastM

#define MkAssertCastM	(		cls,
			m )

Value:

((cls##_type)(({MK_OBJ o=(MK_OBJ)(m);MkAssertO(cls,o);o;})))

}

cast m to cls but allow the null value, on fail raise an assert error.

Definition at line 3323 of file LibMkKernel_mk.h.

MkAssertO

#define MkAssertO	(		cls,
			o )

Value:

assert(o==NULL?true:__MkCheckO(cls,o))

assert on invalid ptr but allow the null ptr {

Definition at line 3315 of file LibMkKernel_mk.h.

MkAssertX

#define MkAssertX	(		cls,
			x )

Value:

assert(x==NULL?true:__MkCheckX(cls,o))

Definition at line 3316 of file LibMkKernel_mk.h.

MkCheckNN

#define MkCheckNN	(		cls,
			x )

Value:

__MkCheckO(cls,(cls##_X2obj(x)))

Definition at line 3302 of file LibMkKernel_mk.h.

MkDbgDeepWriter

#define MkDbgDeepWriter

(

...

)

Definition at line 3372 of file LibMkKernel_mk.h.

MkDbgDeepX_2

#define MkDbgDeepX_2	(		m,
			ident )

Value:

MkDbgDeepX_4(m,ident,__func__,NULL,NULL)

Definition at line 3378 of file LibMkKernel_mk.h.

MkDbgDeepX_3

#define MkDbgDeepX_3	(		m,
			ident,
			fmt,
			... )

Value:

MkDbgDeepX_4(m,ident,__func__,fmt,__VA_ARGS__)

Definition at line 3377 of file LibMkKernel_mk.h.

MkDbgDeepX_4

#define MkDbgDeepX_4	(		m,
			ident,
			func,
			fmt,
			... )

Value:

MkDbgDeepWriter(m, ident, func, fmt, __VA_ARGS__)

Definition at line 3376 of file LibMkKernel_mk.h.

MkDbgObjInstancesO

#define MkDbgObjInstancesO

(

o

)

Value:

MkDbgObjInstancesO_2(o,MK_COLOR_CYAN)

Definition at line 3363 of file LibMkKernel_mk.h.

MkDbgObjInstancesO_2

#define MkDbgObjInstancesO_2	(		o,
			c )

Value:

do { \
  if (o) { \
    mk_dbg_color_ln(c,"MkDbgObjInstances: %s[%p] prev<%p>, next<%p>, var<" #o ">", \
            (o)->type->type_name, o, (o)->obj_protect.prev, (o)->obj_protect.next); \
  } else { \
    mk_dbg_color_ln(c,"MkDbgObjInstances: %s[NULL] var<" #o ">", "unknown"); \
  } \
} while (0)

Definition at line 3352 of file LibMkKernel_mk.h.

#define MkDbgObjInstancesO_2(o,c) \
do { \
  if (o) { \
    mk_dbg_color_ln(c,"MkDbgObjInstances: %s[%p] prev<%p>, next<%p>, var<" #o ">", \
            (o)->type->type_name, o, (o)->obj_protect.prev, (o)->obj_protect.next); \
  } else { \
    mk_dbg_color_ln(c,"MkDbgObjInstances: %s[NULL] var<" #o ">", "unknown"); \
  } \
} while (0)

MkDbgObjInstancesX

#define MkDbgObjInstancesX

(

x

)

Value:

MkDbgObjInstancesX_2(x,MK_COLOR_CYAN)

Definition at line 3362 of file LibMkKernel_mk.h.

MkDbgObjInstancesX_2

#define MkDbgObjInstancesX_2	(		x,
			c )

Value:

MkDbgObjInstancesO_2(MkOBJ(x),c)

Definition at line 3361 of file LibMkKernel_mk.h.

MkSanitizeCheck

#define MkSanitizeCheck	(		_root,
			_m )

Value:

_MkCheckM(_root,_m)

Definition at line 3309 of file LibMkKernel_mk.h.

MkSanitizeCheckO

#define MkSanitizeCheckO	(		_root,
			_o )

Value:

_MkCheckO(_root,_o)

Definition at line 3310 of file LibMkKernel_mk.h.

toTT

#define toTT

(

_type

)

Value:

(MkTYP(_type))

Definition at line 3326 of file LibMkKernel_mk.h.

Typedef Documentation

MkAllocCreateFLT

typedef MK_PTR(* MkAllocCreateFLT) (MK_RT mkrt,MK_TYP const type)

Definition at line 3733 of file LibMkKernel_mk.h.

MkAllocDeleteF

typedef void(* MkAllocDeleteF) (MK_RT mkrt,MK_TYP const type, MK_PTR ptr)

Definition at line 3734 of file LibMkKernel_mk.h.

MkConstructorF

typedef MK_OBJ(* MkConstructorF) (MK_RT mkrt,MK_TYP type, MK_PTR nat, MK_PTR lnk)

Definition at line 3717 of file LibMkKernel_mk.h.

MkCopyF

typedef MK_OBJ(* MkCopyF) (MK_RT mkrt,MK_OBJ const obj, MK_OBJN const src)

Definition at line 3722 of file LibMkKernel_mk.h.

MkDestructorF

typedef void(* MkDestructorF) (MK_RT mkrt,MK_OBJ const obj)

Definition at line 3718 of file LibMkKernel_mk.h.

MkDup2F

typedef MK_OBJ(* MkDup2F) (MK_RT mkrt,MK_OBJN const obj, MK_STRN const ident)

Definition at line 3720 of file LibMkKernel_mk.h.

MkDupF

typedef MK_OBJ(* MkDupF) (MK_RT mkrt,MK_OBJN const obj)

Definition at line 3719 of file LibMkKernel_mk.h.

MkLogF

typedef void(* MkLogF) (MK_RT mkrt,MK_OBJN const obj, MK_OBJN fmt, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)

Definition at line 3730 of file LibMkKernel_mk.h.

MkLogFormatF

typedef bool(* MkLogFormatF) (MK_RT mkrt,char *header, MK_SIZE const headerSize, MK_OBJN const obj, MK_STRN const caller, MK_I32 const debug, MK_STRN const fmt)

Definition at line 3736 of file LibMkKernel_mk.h.

MkMergeF

typedef MK_OBJ(* MkMergeF) (MK_RT mkrt,MK_OBJ const obj)

Definition at line 3721 of file LibMkKernel_mk.h.

MkResetF

typedef MK_OBJ(* MkResetF) (MK_RT mkrt,MK_OBJ const obj)

Definition at line 3723 of file LibMkKernel_mk.h.

MkSelfCreateF

typedef MK_PTR(* MkSelfCreateF) (MK_RT mkrt,MK_OBJ const obj, MK_PTR const env)

Definition at line 3725 of file LibMkKernel_mk.h.

MkSelfDeleteF

typedef void(* MkSelfDeleteF) (MK_RT mkrt,MK_PTR self, MK_PTR const env)

Definition at line 3727 of file LibMkKernel_mk.h.

MkSelfUnlinkF

typedef void(* MkSelfUnlinkF) (MK_RT mkrt,MK_PTR self, MK_PTR const env)

Definition at line 3729 of file LibMkKernel_mk.h.

MkToStringF

typedef MK_STRN(* MkToStringF) (MK_RT mkrt,MK_OBJN const obj)

Definition at line 3732 of file LibMkKernel_mk.h.

MkTypeInitF

typedef void(* MkTypeInitF) (MK_RT mkrt,MK_TYP const type)

Definition at line 3735 of file LibMkKernel_mk.h.