MkObjectC - log information to MkLogFileC (default: stderr) … More...

Collaboration diagram for MkObjectC_Log_CS_API:

Functions
void	csmkkernel.MkObjectC.LogC (string message, int debug=0, [CallerMemberName]string callfunc=null)
	`C#: fmtobj.LogC(string message, int debug = 0, [CallerMemberName]string callfunc = null)` → C-API write a logging-message to MkLogFileC (default: stderr) using the internal format …

void	csmkkernel.MkObjectC.LogHEX (string callfunc, byte[] data)
	`C#: fmtobj.LogHEX(string callfunc, byte[] data)` → C-API log binaray data as HEX into the MkLogFileC (default: stderr) …

void	csmkkernel.MkObjectC.Log (MkObjectC fmtobj=null, int debug=0, [CallerMemberName]string callfunc=null, int lvl=0)
	`C#: obj.Log(MkObjectC fmtobj = null, int debug = 0, [CallerMemberName]string callfunc = null, int lvl = 0)` → C-API Log-Slot - log a summary of an object to the MkLogFileC (default: stderr) target …

void	csmkkernel.MkObjectC.LogLong (MkObjectC fmtobj=null, int debug=0, [CallerMemberName]string callfunc=null, int lvl=0)
	`C#: obj.LogLong(MkObjectC fmtobj = null, int debug = 0, [CallerMemberName]string callfunc = null, int lvl = 0)` → C-API log the MkObjectS verbose into the MkLogFileC (default: stderr) …

void	csmkkernel.MkObjectC.LogShort (MkObjectC fmtobj=null, int debug=0, [CallerMemberName]string callfunc=null, int lvl=0)
	`C#: obj.LogShort(MkObjectC fmtobj = null, int debug = 0, [CallerMemberName]string callfunc = null, int lvl = 0)` → C-API log the MkObjectS into the MkLogFileC (default: stderr) …

void	csmkkernel.MkObjectC.LogType (MkObjectC fmtobj=null, int debug=0, [CallerMemberName]string callfunc=null, int lvl=0)
	`C#: obj.LogType(MkObjectC fmtobj = null, int debug = 0, [CallerMemberName]string callfunc = null, int lvl = 0)` → C-API log the tyoe of the MkObjectS into the MkLogFileC (default: stderr) …

Detailed Description

MkObjectC - log information to MkLogFileC (default: stderr) …

The logging-target is set direct by RuntimeLogTargetSet or using the class MkLogFileC.

The target is stored at the MkRuntimeC using a FILE-stream and can be set individually for each thread. The default is stderr.

the handle is stored at MkLogDataS::logFILE
the filename (if available) is stored at MkRuntimeS::log

possible values are:

value	decription	OS man-page
stdout	the standart output	stdio(3)
stderr	the standart error output	stdio(3)
fileName	an arbitary fileName	fopen(3)

Many logging functions have common parameters:

Parameters

[in]	fmtobj	managed object used to format the log-message (default=null → use default-format)
[in]	callfunc	a user-defined postfix to identify the calling-function or the environment (default = name-of-function, null = resolve-own-name)
[in]	debug	the `debug level` from MkRuntimeS::debug, use `0 <= debug <= 9` (default=`0`)

Function Documentation

◆ Log()

void csmkkernel.MkObjectC.Log	(	MkObjectC	fmtobj = null,
		int	debug = 0,
		[CallerMemberName] string	callfunc = null,
		int	lvl = 0 )

inline

C#: obj.Log(MkObjectC fmtobj = null, int debug = 0, [CallerMemberName]string callfunc = null, int lvl = 0) → C-API
Log-Slot - log a summary of an object to the MkLogFileC (default: stderr) target …

Definition at line 527 of file MkObjectC.cs.

                                                                                                                     {
      IntPtr fmtobj_hdl = MkObjectC.getOBJ_null_allow(fmtobj);
      if (debug > (int)(MkRuntimeC.DebugGet())) {return;}
      IntPtr callfunc_cstr = Marshal.StringToHGlobalAnsi(callfunc);
      Mk.MkObjectLog(mkrt, hdl, fmtobj_hdl, debug, callfunc_cstr, lvl);
      Marshal.FreeHGlobal(callfunc_cstr);
    }

◆ LogC()

void csmkkernel.MkObjectC.LogC	(	string	message,
		int	debug = 0,
		[CallerMemberName] string	callfunc = null )

inline

C#: fmtobj.LogC(string message, int debug = 0, [CallerMemberName]string callfunc = null) → C-API
write a logging-message to MkLogFileC (default: stderr) using the internal format …

Definition at line 506 of file MkObjectC.cs.

                                                                                                {
      if (debug > (int)(MkRuntimeC.DebugGet())) {return;}
      IntPtr message_cstr = Marshal.StringToHGlobalAnsi(message);
      IntPtr callfunc_cstr = Marshal.StringToHGlobalAnsi(callfunc);
      Mk.MkLogC(mkrt, hdl_null_allow, message_cstr, debug, callfunc_cstr);
      Marshal.FreeHGlobal(message_cstr);
      Marshal.FreeHGlobal(callfunc_cstr);
    }

◆ LogHEX()

void csmkkernel.MkObjectC.LogHEX	(	string	callfunc,
		byte[]	data )

inline

C#: fmtobj.LogHEX(string callfunc, byte[] data) → C-API
log binaray data as HEX into the MkLogFileC (default: stderr) …

Definition at line 516 of file MkObjectC.cs.

                                                       {
      IntPtr callfunc_cstr = Marshal.StringToHGlobalAnsi(callfunc);
      var data_size = Marshal.SizeOf(data[0]) * data.Length;
      var data_data = Marshal.AllocHGlobal(data_size);
      Marshal.Copy(data,0,data_data,data_size);
      Mk.MkBinaryR data_ref = Mk.MkBinaryCreate(data_size,data_data);
      Mk.MkLogHEX(mkrt, hdl_null_allow, callfunc_cstr, data_ref);
      Marshal.FreeHGlobal(callfunc_cstr);
    }

◆ LogLong()

void csmkkernel.MkObjectC.LogLong	(	MkObjectC	fmtobj = null,
		int	debug = 0,
		[CallerMemberName] string	callfunc = null,
		int	lvl = 0 )

inline

C#: obj.LogLong(MkObjectC fmtobj = null, int debug = 0, [CallerMemberName]string callfunc = null, int lvl = 0) → C-API
log the MkObjectS verbose into the MkLogFileC (default: stderr) …

Definition at line 536 of file MkObjectC.cs.

                                                                                                                         {
      IntPtr fmtobj_hdl = MkObjectC.getOBJ_null_allow(fmtobj);
      if (debug > (int)(MkRuntimeC.DebugGet())) {return;}
      IntPtr callfunc_cstr = Marshal.StringToHGlobalAnsi(callfunc);
      Mk.MkObjectLogLong(mkrt, hdl, fmtobj_hdl, debug, callfunc_cstr, lvl);
      Marshal.FreeHGlobal(callfunc_cstr);
    }

◆ LogShort()

void csmkkernel.MkObjectC.LogShort	(	MkObjectC	fmtobj = null,
		int	debug = 0,
		[CallerMemberName] string	callfunc = null,
		int	lvl = 0 )

inline

C#: obj.LogShort(MkObjectC fmtobj = null, int debug = 0, [CallerMemberName]string callfunc = null, int lvl = 0) → C-API
log the MkObjectS into the MkLogFileC (default: stderr) …

Definition at line 545 of file MkObjectC.cs.

                                                                                                                          {
      IntPtr fmtobj_hdl = MkObjectC.getOBJ_null_allow(fmtobj);
      if (debug > (int)(MkRuntimeC.DebugGet())) {return;}
      IntPtr callfunc_cstr = Marshal.StringToHGlobalAnsi(callfunc);
      Mk.MkObjectLogShort(mkrt, hdl, fmtobj_hdl, debug, callfunc_cstr, lvl);
      Marshal.FreeHGlobal(callfunc_cstr);
    }

◆ LogType()

void csmkkernel.MkObjectC.LogType	(	MkObjectC	fmtobj = null,
		int	debug = 0,
		[CallerMemberName] string	callfunc = null,
		int	lvl = 0 )

inline

C#: obj.LogType(MkObjectC fmtobj = null, int debug = 0, [CallerMemberName]string callfunc = null, int lvl = 0) → C-API
log the tyoe of the MkObjectS into the MkLogFileC (default: stderr) …

Definition at line 554 of file MkObjectC.cs.

                                                                                                                         {
      IntPtr fmtobj_hdl = MkObjectC.getOBJ_null_allow(fmtobj);
      if (debug > (int)(MkRuntimeC.DebugGet())) {return;}
      IntPtr callfunc_cstr = Marshal.StringToHGlobalAnsi(callfunc);
      Mk.MkObjectLogType(mkrt, hdl, fmtobj_hdl, debug, callfunc_cstr, lvl);
      Marshal.FreeHGlobal(callfunc_cstr);
    }

Functions

Detailed Description

Function Documentation

◆ Log()

◆ LogC()

◆ LogHEX()

◆ LogLong()

◆ LogShort()

◆ LogType()