theKernel 10.0 NHI1 - theKernel - theLink - theConfig - theSq3Lite - theCompiler - theBrain - theGuard
c - tcl - cs - py - rb - jv - cc
Loading...
Searching...
No Matches
MkObjectC_Dbg_C_API

MkObjectC - log a debugging-message to the MkLogFileC (default: stderr) … More...

+ Collaboration diagram for MkObjectC_Dbg_C_API:

Macros

#define MkDbgL_2M(x, message)
 
#define MkDbgDump_2M(x, message)
 
#define MkDbgSTACK_3X(x, num, callfunc)
 
#define MkDbgO_2X(x, callfunc)
 
#define MkDbgO_1X(x)
 
#define MkDbgO_1O(x)
 
#define MkDbgLogC_2X(x, callfunc)
 debug: write a short-obj-summary to MkLogFileC (default: stderr) …
 

Functions

void MkDbgL_RT (MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const message, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)
 debug: write a instance-marker to the MkLogFileC (default: stderr) using the fmtobj as prefix …
 
enum MkErrorE MkDbgDump_RT (MK_RT mkrt, MK_OBJN const obj, MK_STRN const message, MK_STRN const callfunc)
 debug: Dump a instance to stderr with LNG and MQ internal data…
 
void MkDbgM_RT (MK_RT mkrt, MK_STRN const message, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)
 debug: write a static-marker to the MkLogFileC (default: stderr) …
 
void MkDbgSTACK_RT (MK_RT mkrt, MK_OBJN fmtobj, MK_I32 const skip, MK_I32 const num, MK_STRN const callfunc)
 debug: write the stack-trace to MkLogFileC (default: stderr) …
 
void MkDbgO_RT (MK_RT mkrt, MK_OBJN const obj, MK_STRN const callfunc)
 debug: write the object-details to MkLogFileC (default: stderr) …
 
void MkDbgLogC_RT (MK_RT mkrt, MK_OBJN const obj, MK_STRN const callfunc)
 debug: write a short-obj-summary to MkLogFileC (default: stderr) …
 

MkObjectC - MkObjectC_Dbg_C_API - overload

#define MkDbgDump_NULL(...)
 
#define MkDbgDump(...)
 
#define MkDbgDump_2(obj, message)
 
#define MkDbgDump_1(obj)
 
#define MkDbgDump_E(...)
 
#define MkDbgDump_C(...)
 
#define MkDbgL_NULL(...)
 
#define MkDbgL(...)
 
#define MkDbgL_4(fmtobj, message, debug, callfunc)
 
#define MkDbgL_3(fmtobj, message, debug)
 
#define MkDbgL_2(fmtobj, message)
 
#define MkDbgL_1(message)
 
#define MkDbgLogC_NULL(...)
 
#define MkDbgLogC(...)
 
#define MkDbgLogC_1(obj)
 
#define MkDbgO_NULL(...)
 
#define MkDbgO(...)
 
#define MkDbgO_1(obj)
 
#define MkDbgSTACK_NULL(...)
 
#define MkDbgSTACK(...)
 
#define MkDbgSTACK_3(fmtobj, skip, num)
 
#define MkDbgSTACK_2(fmtobj, skip)
 
#define MkDbgSTACK_1(fmtobj)
 
#define MkDbgSTACK_0()
 
#define MkDbgM_NULL(...)
 
#define MkDbgM(...)
 
#define MkDbgM_3(message, debug, callfunc)
 
#define MkDbgM_2(message, debug)
 
#define MkDbgM_1(message)
 

Detailed Description

MkObjectC - log a debugging-message to the MkLogFileC (default: stderr) …

This functions are "helpers" to support the programmer.

Macro Definition Documentation

◆ MkDbgDump

#define MkDbgDump ( ...)
Value:
enum MkErrorE MkDbgDump_RT(MK_RT mkrt, MK_OBJN const obj, MK_STRN const message, MK_STRN const callfunc)
debug: Dump a instance to stderr with LNG and MQ internal data…
#define MK_RT_CALL

Definition at line 1524 of file kernel_overload_mk.h.

◆ MkDbgDump_1

#define MkDbgDump_1 ( obj)
Value:
MkDbgDump(obj,"var",__func__)
#define MkDbgDump(...)

Definition at line 1526 of file kernel_overload_mk.h.

◆ MkDbgDump_2

#define MkDbgDump_2 ( obj,
message )
Value:
MkDbgDump(obj,message,__func__)

Definition at line 1525 of file kernel_overload_mk.h.

◆ MkDbgDump_2M

#define MkDbgDump_2M ( x,
message )
Value:
MkDbgDump_2(MkObj(x),message)
static MK_OBJ MkObj(MK_MNG mng)
cast a unknown-object into an MkObjectS pointer or NULL if not possible
#define MkDbgDump_2(obj, message)

Definition at line 5426 of file LibMkKernel_mk.h.

◆ MkDbgDump_C

#define MkDbgDump_C ( ...)
Value:
if (MkErrorCheckI(MkDbgDump(__VA_ARGS__)))
#define MkErrorCheckI(err)

Definition at line 1528 of file kernel_overload_mk.h.

◆ MkDbgDump_E

#define MkDbgDump_E ( ...)
Value:
MkErrorCheck(MkDbgDump(__VA_ARGS__))
#define MkErrorCheck(err)
check return-code and goto error on error …

Definition at line 1527 of file kernel_overload_mk.h.

◆ MkDbgDump_NULL

#define MkDbgDump_NULL ( ...)
Value:
#define MK_RT_CALL_NULL

Definition at line 1523 of file kernel_overload_mk.h.

◆ MkDbgL

#define MkDbgL ( ...)
Value:
MkDbgL_RT(MK_RT_CALL __VA_ARGS__)
void MkDbgL_RT(MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const message, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)
debug: write a instance-marker to the MkLogFileC (default: stderr) using the fmtobj as prefix …

Definition at line 1530 of file kernel_overload_mk.h.

◆ MkDbgL_1

#define MkDbgL_1 ( message)
Value:
MkDbgL(NULL,message,0,__func__,0)
#define MkDbgL(...)

Definition at line 1534 of file kernel_overload_mk.h.

◆ MkDbgL_2

#define MkDbgL_2 ( fmtobj,
message )
Value:
MkDbgL(fmtobj,message,0,__func__,0)

Definition at line 1533 of file kernel_overload_mk.h.

◆ MkDbgL_2M

#define MkDbgL_2M ( x,
message )
Value:
MkDbgL(MkObj(x),message,0,__func__,-1)

Definition at line 5413 of file LibMkKernel_mk.h.

◆ MkDbgL_3

#define MkDbgL_3 ( fmtobj,
message,
debug )
Value:
MkDbgL(fmtobj,message,debug,__func__,0)

Definition at line 1532 of file kernel_overload_mk.h.

◆ MkDbgL_4

#define MkDbgL_4 ( fmtobj,
message,
debug,
callfunc )
Value:
MkDbgL(fmtobj,message,debug,callfunc,0)

Definition at line 1531 of file kernel_overload_mk.h.

◆ MkDbgL_NULL

#define MkDbgL_NULL ( ...)
Value:

Definition at line 1529 of file kernel_overload_mk.h.

◆ MkDbgLogC

#define MkDbgLogC ( ...)
Value:
void MkDbgLogC_RT(MK_RT mkrt, MK_OBJN const obj, MK_STRN const callfunc)
debug: write a short-obj-summary to MkLogFileC (default: stderr) …

Definition at line 1536 of file kernel_overload_mk.h.

◆ MkDbgLogC_1

#define MkDbgLogC_1 ( obj)
Value:
MkDbgLogC(obj,__func__)
#define MkDbgLogC(...)

Definition at line 1537 of file kernel_overload_mk.h.

◆ MkDbgLogC_2X

#define MkDbgLogC_2X ( x,
callfunc )
Value:
MkDbgLogC_2(MkOBJ(x),callfunc)
#define MkOBJ(x)
cast a known-object into an MkObjectS pointer

debug: write a short-obj-summary to MkLogFileC (default: stderr) …

Definition at line 5475 of file LibMkKernel_mk.h.

◆ MkDbgLogC_NULL

#define MkDbgLogC_NULL ( ...)
Value:

Definition at line 1535 of file kernel_overload_mk.h.

◆ MkDbgM

#define MkDbgM ( ...)
Value:
MkDbgM_RT(MK_RT_CALL __VA_ARGS__)
void MkDbgM_RT(MK_RT mkrt, MK_STRN const message, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)
debug: write a static-marker to the MkLogFileC (default: stderr) …

Definition at line 1550 of file kernel_overload_mk.h.

◆ MkDbgM_1

#define MkDbgM_1 ( message)
Value:
MkDbgM(message,0,__func__,0)
#define MkDbgM(...)

Definition at line 1553 of file kernel_overload_mk.h.

◆ MkDbgM_2

#define MkDbgM_2 ( message,
debug )
Value:
MkDbgM(message,debug,__func__,0)

Definition at line 1552 of file kernel_overload_mk.h.

◆ MkDbgM_3

#define MkDbgM_3 ( message,
debug,
callfunc )
Value:
MkDbgM(message,debug,callfunc,0)

Definition at line 1551 of file kernel_overload_mk.h.

◆ MkDbgM_NULL

#define MkDbgM_NULL ( ...)
Value:

Definition at line 1549 of file kernel_overload_mk.h.

◆ MkDbgO

#define MkDbgO ( ...)
Value:
MkDbgO_RT(MK_RT_CALL __VA_ARGS__)
void MkDbgO_RT(MK_RT mkrt, MK_OBJN const obj, MK_STRN const callfunc)
debug: write the object-details to MkLogFileC (default: stderr) …

Definition at line 1539 of file kernel_overload_mk.h.

◆ MkDbgO_1

#define MkDbgO_1 ( obj)
Value:
MkDbgO(obj,__func__)
#define MkDbgO(...)

Definition at line 1540 of file kernel_overload_mk.h.

◆ MkDbgO_1O

#define MkDbgO_1O ( x)
Value:
MkDbgO(x,__func__)

Definition at line 5464 of file LibMkKernel_mk.h.

◆ MkDbgO_1X

#define MkDbgO_1X ( x)
Value:
MkDbgO_2X(x,__func__)
#define MkDbgO_2X(x, callfunc)

Definition at line 5463 of file LibMkKernel_mk.h.

◆ MkDbgO_2X

#define MkDbgO_2X ( x,
callfunc )
Value:
MkDbgO(MkObj(x),callfunc)

Definition at line 5462 of file LibMkKernel_mk.h.

◆ MkDbgO_NULL

#define MkDbgO_NULL ( ...)
Value:

Definition at line 1538 of file kernel_overload_mk.h.

◆ MkDbgSTACK

#define MkDbgSTACK ( ...)
Value:
void MkDbgSTACK_RT(MK_RT mkrt, MK_OBJN fmtobj, MK_I32 const skip, MK_I32 const num, MK_STRN const callfunc)
debug: write the stack-trace to MkLogFileC (default: stderr) …

Definition at line 1542 of file kernel_overload_mk.h.

◆ MkDbgSTACK_0

#define MkDbgSTACK_0 ( )
Value:
MkDbgSTACK(NULL,0,-1,__func__)
#define MkDbgSTACK(...)

Definition at line 1546 of file kernel_overload_mk.h.

◆ MkDbgSTACK_1

#define MkDbgSTACK_1 ( fmtobj)
Value:
MkDbgSTACK(fmtobj,0,-1,__func__)

Definition at line 1545 of file kernel_overload_mk.h.

◆ MkDbgSTACK_2

#define MkDbgSTACK_2 ( fmtobj,
skip )
Value:
MkDbgSTACK(fmtobj,skip,-1,__func__)

Definition at line 1544 of file kernel_overload_mk.h.

◆ MkDbgSTACK_3

#define MkDbgSTACK_3 ( fmtobj,
skip,
num )
Value:
MkDbgSTACK(fmtobj,skip,num,__func__)

Definition at line 1543 of file kernel_overload_mk.h.

◆ MkDbgSTACK_3X

#define MkDbgSTACK_3X ( x,
num,
callfunc )
Value:
MkDbgSTACK_3(MkOBJ(x),num,callfunc)
#define MkDbgSTACK_3(fmtobj, skip, num)

Definition at line 5446 of file LibMkKernel_mk.h.

◆ MkDbgSTACK_NULL

#define MkDbgSTACK_NULL ( ...)
Value:

Definition at line 1541 of file kernel_overload_mk.h.

Function Documentation

◆ MkDbgDump_RT()

enum MkErrorE MkDbgDump_RT ( MK_RT mkrt,
MK_OBJN const obj,
MK_STRN const message,
MK_STRN const callfunc )

debug: Dump a instance to stderr with LNG and MQ internal data…

Attention
this is only implemented by the Target-Programming-Language (TPL)

◆ MkDbgL_RT()

void MkDbgL_RT ( MK_RT mkrt,
MK_OBJN fmtobj,
MK_STRN const message,
MK_DBG const debug,
MK_STRN const callfunc,
MK_I32 const lvl )

debug: write a instance-marker to the MkLogFileC (default: stderr) using the fmtobj as prefix …

The marker is prefixed with object data from th fmtobj.

◆ MkDbgLogC_RT()

void MkDbgLogC_RT ( MK_RT mkrt,
MK_OBJN const obj,
MK_STRN const callfunc )

debug: write a short-obj-summary to MkLogFileC (default: stderr) …

◆ MkDbgM_RT()

void MkDbgM_RT ( MK_RT mkrt,
MK_STRN const message,
MK_DBG const debug,
MK_STRN const callfunc,
MK_I32 const lvl )

debug: write a static-marker to the MkLogFileC (default: stderr) …

◆ MkDbgO_RT()

void MkDbgO_RT ( MK_RT mkrt,
MK_OBJN const obj,
MK_STRN const callfunc )

debug: write the object-details to MkLogFileC (default: stderr) …

Parameters
[in]mkrtthe MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]objthe MkObjectS instance to work on - a MANAGED OBJECT after type-check and able to be supported by the MkObjectS API (MK_NULL allowed)
[in]callfunca user-defined postfix to identify the calling function or the environment (default=name-of-function)

This function can be overwritten in the target programming language.

◆ MkDbgSTACK_RT()

void MkDbgSTACK_RT ( MK_RT mkrt,
MK_OBJN fmtobj,
MK_I32 const skip,
MK_I32 const num,
MK_STRN const callfunc )

debug: write the stack-trace to MkLogFileC (default: stderr) …