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

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

+ Collaboration diagram for MkObjectC_Log_CC_API:

Functions

void ccmkkernel::MkObjectC::LogC (MK_STRN message, MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION()) const
  C++: fmtobj.LogC(MK_STRN message, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION()) C-API
write a logging-message to MkLogFileC (default: stderr) using the internal format …
 
void ccmkkernel::MkObjectC::LogC (const std::string &message, MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION()) const
  C++: fmtobj.LogC(MK_STRN message, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION()) C-API
write a logging-message to MkLogFileC (default: stderr) using the internal format …
 
void ccmkkernel::MkObjectC::LogHEX (MK_STRN callfunc, MK_BNP data) const
  C++: fmtobj.LogHEX(MK_STRN callfunc, MK_BNP data) C-API
log binaray data as HEX into the MkLogFileC (default: stderr) …
 
void ccmkkernel::MkObjectC::LogHEX (const std::string &callfunc, MK_BNP data) const
  C++: fmtobj.LogHEX(MK_STRN callfunc, MK_BNP data) C-API
log binaray data as HEX into the MkLogFileC (default: stderr) …
 
void ccmkkernel::MkObjectC::LogV (MK_STRN callfunc, MK_DBG debug, MK_FST printfmt,...) const
  C++: fmtobj.LogV(MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, ... ) C-API
write a printf style logging-message to MkLogFileC (default: stderr) using the internal format …
 
void ccmkkernel::MkObjectC::LogV (const std::string &callfunc, MK_DBG debug, MK_FST printfmt,...) const
  C++: fmtobj.LogV(MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, ... ) C-API
write a printf style logging-message to MkLogFileC (default: stderr) using the internal format …
 
void ccmkkernel::MkObjectC::LogVL (MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, va_list var_list) const
  C++: fmtobj.LogVL(MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, va_list var_list) C-API
write a vprintf style logging-message to MkLogFileC using the internal format …
 
void ccmkkernel::MkObjectC::LogVL (const std::string &callfunc, MK_DBG debug, MK_FST printfmt, va_list var_list) const
  C++: fmtobj.LogVL(MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, va_list var_list) C-API
write a vprintf style logging-message to MkLogFileC using the internal format …
 
void ccmkkernel::MkObjectC::Log (const MkObjectC *fmtobj=NULL, MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION(), MK_I32 lvl=0) const
  C++: obj.Log(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
Log-Slot - log a summary of an object to the MkLogFileC (default: stderr) target …
 
void ccmkkernel::MkObjectC::Log (const MkObjectC &fmtobj, MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION(), MK_I32 lvl=0) const
  C++: obj.Log(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
Log-Slot - log a summary of an object to the MkLogFileC (default: stderr) target …
 
void ccmkkernel::MkObjectC::LogDetail (const MkObjectC *fmtobj=NULL, MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION(), MK_I32 lvl=0) const
  C++: obj.LogDetail(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
log the MkObjectS verbose into the MkLogFileC (default: stderr) …
 
void ccmkkernel::MkObjectC::LogDetail (const MkObjectC &fmtobj, MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION(), MK_I32 lvl=0) const
  C++: obj.LogDetail(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
log the MkObjectS verbose into the MkLogFileC (default: stderr) …
 
void ccmkkernel::MkObjectC::LogSimple (const MkObjectC *fmtobj=NULL, MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION(), MK_I32 lvl=0) const
  C++: obj.LogSimple(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
log the MkObjectS into the MkLogFileC (default: stderr) …
 
void ccmkkernel::MkObjectC::LogSimple (const MkObjectC &fmtobj, MK_DBG debug=0, MK_STRN callfunc=__builtin_FUNCTION(), MK_I32 lvl=0) const
  C++: obj.LogSimple(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
log the MkObjectS into the MkLogFileC (default: stderr) …
 

Detailed Description

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

The logging-target is set direct by RuntimeSetLogfile 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.

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]fmtobjmanaged object used to format the log-message (default=MK_NULL → use default-format)
[in]callfunca user-defined postfix to identify the calling function or the environment (default=name-of-function)
[in]debugthe debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0)

The logging-target is set direct by RuntimeSetLogfile 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.

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]fmtobjmanaged object used to format the log-message (default=MK_NULL → use default-format)
[in]callfunca user-defined postfix to identify the calling function or the environment (default=name-of-function)
[in]debugthe debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0)

Function Documentation

◆ Log() [1/2]

void ccmkkernel::MkObjectC::Log ( const MkObjectC & fmtobj,
MK_DBG debug = 0,
MK_STRN callfunc = __builtin_FUNCTION(),
MK_I32 lvl = 0 ) const
inline

C++: obj.Log(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
Log-Slot - log a summary of an object to the MkLogFileC (default: stderr) target …

Definition at line 320 of file MkObjectC_inline_cc.hh.

320 {
321 MK_UNUSED auto obj = getOBJN();
322 MkRtSetup_O(obj);
323 const MK_OBJN fmtobj_hdl = MkObjectC::getOBJN(fmtobj);
324 if (callfunc == NULL) {callfunc = __builtin_FUNCTION();}
325 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
326 MkObjectLog(obj, fmtobj_hdl, debug, callfunc, lvl);
327 }
#define MK_UNUSED
mark unnused variables and functions
int MK_DBG
debug-level data-type …
MK_OBJN getOBJN() const
(const) return the LibMsgqueObject from current MkObjectC instance
const struct MkObjectS * MK_OBJN
class-shortcut for const struct MkObjectS *, all const shortcut using the XX_YYYC syntax (only for pu...
#define MkObjectLog(...)
static MK_I32 MkRuntimeGetDebug(void)
get the MkRuntimeS::debug value …
#define MkRtSetup_O(o)

◆ Log() [2/2]

void ccmkkernel::MkObjectC::Log ( const MkObjectC * fmtobj = NULL,
MK_DBG debug = 0,
MK_STRN callfunc = __builtin_FUNCTION(),
MK_I32 lvl = 0 ) const
inline

C++: obj.Log(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
Log-Slot - log a summary of an object to the MkLogFileC (default: stderr) target …

Definition at line 310 of file MkObjectC_inline_cc.hh.

310 {
311 MK_UNUSED auto obj = getOBJN();
312 MkRtSetup_O(obj);
313 MK_OBJN fmtobj_hdl = MkObjectC::getOBJN__null_allow(fmtobj);
314 if (callfunc == NULL) {callfunc = __builtin_FUNCTION();}
315 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
316 MkObjectLog(obj, fmtobj_hdl, debug, callfunc, lvl);
317 }
MK_OBJN getOBJN__null_allow() const
(const) return the LibMsgqueObject from current MkObjectC instance

◆ LogC() [1/2]

void ccmkkernel::MkObjectC::LogC ( const std::string & message,
MK_DBG debug = 0,
MK_STRN callfunc = __builtin_FUNCTION() ) const
inline

C++: fmtobj.LogC(MK_STRN message, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION()) C-API
write a logging-message to MkLogFileC (default: stderr) using the internal format …

Definition at line 243 of file MkObjectC_inline_cc.hh.

243 {
244 MK_UNUSED auto fmtobj = getOBJN__null_allow();
245 MkRtSetup_O(fmtobj);
246 const MK_STRN message_hdl = message.c_str();
247 if (callfunc == NULL) {callfunc = __builtin_FUNCTION();}
248 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
249 MkLogC(fmtobj, message_hdl, debug, callfunc);
250 }
const MK_STRB * MK_STRN
constant string pointer data-type
#define MkLogC(...)

◆ LogC() [2/2]

void ccmkkernel::MkObjectC::LogC ( MK_STRN message,
MK_DBG debug = 0,
MK_STRN callfunc = __builtin_FUNCTION() ) const
inline

C++: fmtobj.LogC(MK_STRN message, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION()) C-API
write a logging-message to MkLogFileC (default: stderr) using the internal format …

Definition at line 234 of file MkObjectC_inline_cc.hh.

234 {
235 MK_UNUSED auto fmtobj = getOBJN__null_allow();
236 MkRtSetup_O(fmtobj);
237 if (callfunc == NULL) {callfunc = __builtin_FUNCTION();}
238 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
239 MkLogC(fmtobj, message, debug, callfunc);
240 }

◆ LogDetail() [1/2]

void ccmkkernel::MkObjectC::LogDetail ( const MkObjectC & fmtobj,
MK_DBG debug = 0,
MK_STRN callfunc = __builtin_FUNCTION(),
MK_I32 lvl = 0 ) const
inline

C++: obj.LogDetail(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
log the MkObjectS verbose into the MkLogFileC (default: stderr) …

Definition at line 340 of file MkObjectC_inline_cc.hh.

340 {
341 MK_UNUSED auto obj = getOBJN();
342 MkRtSetup_O(obj);
343 const MK_OBJN fmtobj_hdl = MkObjectC::getOBJN(fmtobj);
344 if (callfunc == NULL) {callfunc = __builtin_FUNCTION();}
345 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
346 MkObjectLogDetail(obj, fmtobj_hdl, debug, callfunc, lvl);
347 }
#define MkObjectLogDetail(...)

◆ LogDetail() [2/2]

void ccmkkernel::MkObjectC::LogDetail ( const MkObjectC * fmtobj = NULL,
MK_DBG debug = 0,
MK_STRN callfunc = __builtin_FUNCTION(),
MK_I32 lvl = 0 ) const
inline

C++: obj.LogDetail(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
log the MkObjectS verbose into the MkLogFileC (default: stderr) …

Definition at line 330 of file MkObjectC_inline_cc.hh.

330 {
331 MK_UNUSED auto obj = getOBJN();
332 MkRtSetup_O(obj);
333 MK_OBJN fmtobj_hdl = MkObjectC::getOBJN__null_allow(fmtobj);
334 if (callfunc == NULL) {callfunc = __builtin_FUNCTION();}
335 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
336 MkObjectLogDetail(obj, fmtobj_hdl, debug, callfunc, lvl);
337 }

◆ LogHEX() [1/2]

void ccmkkernel::MkObjectC::LogHEX ( const std::string & callfunc,
MK_BNP data ) const
inline

C++: fmtobj.LogHEX(MK_STRN callfunc, MK_BNP data) C-API
log binaray data as HEX into the MkLogFileC (default: stderr) …

Definition at line 261 of file MkObjectC_inline_cc.hh.

261 {
262 MK_UNUSED auto fmtobj = getOBJN__null_allow();
263 MkRtSetup_O(fmtobj);
264 const MK_STRN callfunc_hdl = callfunc.c_str();
265 const MkBinaryR data_ref = MkBinaryCreate(data.first,data.second);
266 MkLogHEX(fmtobj, callfunc_hdl, data_ref);
267 }
static MkBinaryR MkBinaryCreate(MK_SIZE size, MK_BINN data)
create a binary from data and size ...
#define MkLogHEX(...)

◆ LogHEX() [2/2]

void ccmkkernel::MkObjectC::LogHEX ( MK_STRN callfunc,
MK_BNP data ) const
inline

C++: fmtobj.LogHEX(MK_STRN callfunc, MK_BNP data) C-API
log binaray data as HEX into the MkLogFileC (default: stderr) …

Definition at line 253 of file MkObjectC_inline_cc.hh.

253 {
254 MK_UNUSED auto fmtobj = getOBJN__null_allow();
255 MkRtSetup_O(fmtobj);
256 const MkBinaryR data_ref = MkBinaryCreate(data.first,data.second);
257 MkLogHEX(fmtobj, callfunc, data_ref);
258 }

◆ LogSimple() [1/2]

void ccmkkernel::MkObjectC::LogSimple ( const MkObjectC & fmtobj,
MK_DBG debug = 0,
MK_STRN callfunc = __builtin_FUNCTION(),
MK_I32 lvl = 0 ) const
inline

C++: obj.LogSimple(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
log the MkObjectS into the MkLogFileC (default: stderr) …

Definition at line 360 of file MkObjectC_inline_cc.hh.

360 {
361 MK_UNUSED auto obj = getOBJN();
362 MkRtSetup_O(obj);
363 const MK_OBJN fmtobj_hdl = MkObjectC::getOBJN(fmtobj);
364 if (callfunc == NULL) {callfunc = __builtin_FUNCTION();}
365 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
366 MkObjectLogSimple(obj, fmtobj_hdl, debug, callfunc, lvl);
367 }
#define MkObjectLogSimple(...)

◆ LogSimple() [2/2]

void ccmkkernel::MkObjectC::LogSimple ( const MkObjectC * fmtobj = NULL,
MK_DBG debug = 0,
MK_STRN callfunc = __builtin_FUNCTION(),
MK_I32 lvl = 0 ) const
inline

C++: obj.LogSimple(const MkObjectC* fmtobj = NULL, MK_DBG debug = 0, MK_STRN callfunc = __builtin_FUNCTION(), MK_I32 lvl = 0) C-API
log the MkObjectS into the MkLogFileC (default: stderr) …

Definition at line 350 of file MkObjectC_inline_cc.hh.

350 {
351 MK_UNUSED auto obj = getOBJN();
352 MkRtSetup_O(obj);
353 MK_OBJN fmtobj_hdl = MkObjectC::getOBJN__null_allow(fmtobj);
354 if (callfunc == NULL) {callfunc = __builtin_FUNCTION();}
355 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
356 MkObjectLogSimple(obj, fmtobj_hdl, debug, callfunc, lvl);
357 }

◆ LogV() [1/2]

void ccmkkernel::MkObjectC::LogV ( const std::string & callfunc,
MK_DBG debug,
MK_FST printfmt,
... ) const
inline

C++: fmtobj.LogV(MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, ... ) C-API
write a printf style logging-message to MkLogFileC (default: stderr) using the internal format …

Definition at line 281 of file MkObjectC_inline_cc.hh.

281 {
282 MK_UNUSED auto fmtobj = getOBJN__null_allow();
283 MkRtSetup_O(fmtobj);
284 const MK_STRN callfunc_hdl = callfunc.c_str();
285 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
286 va_list ap;
287 va_start (ap, printfmt);
288 MkLogVL(fmtobj, callfunc_hdl, debug, printfmt, ap);
289 va_end (ap);
290 }
#define MkLogVL(...)

◆ LogV() [2/2]

void ccmkkernel::MkObjectC::LogV ( MK_STRN callfunc,
MK_DBG debug,
MK_FST printfmt,
... ) const
inline

C++: fmtobj.LogV(MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, ... ) C-API
write a printf style logging-message to MkLogFileC (default: stderr) using the internal format …

Definition at line 270 of file MkObjectC_inline_cc.hh.

270 {
271 MK_UNUSED auto fmtobj = getOBJN__null_allow();
272 MkRtSetup_O(fmtobj);
273 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
274 va_list ap;
275 va_start (ap, printfmt);
276 MkLogVL(fmtobj, callfunc, debug, printfmt, ap);
277 va_end (ap);
278 }

◆ LogVL() [1/2]

void ccmkkernel::MkObjectC::LogVL ( const std::string & callfunc,
MK_DBG debug,
MK_FST printfmt,
va_list var_list ) const
inline

C++: fmtobj.LogVL(MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, va_list var_list) C-API
write a vprintf style logging-message to MkLogFileC using the internal format …

Definition at line 301 of file MkObjectC_inline_cc.hh.

301 {
302 MK_UNUSED auto fmtobj = getOBJN__null_allow();
303 MkRtSetup_O(fmtobj);
304 const MK_STRN callfunc_hdl = callfunc.c_str();
305 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
306 MkLogVL(fmtobj, callfunc_hdl, debug, printfmt, var_list);
307 }

◆ LogVL() [2/2]

void ccmkkernel::MkObjectC::LogVL ( MK_STRN callfunc,
MK_DBG debug,
MK_FST printfmt,
va_list var_list ) const
inline

C++: fmtobj.LogVL(MK_STRN callfunc, MK_DBG debug, MK_FST printfmt, va_list var_list) C-API
write a vprintf style logging-message to MkLogFileC using the internal format …

Definition at line 293 of file MkObjectC_inline_cc.hh.

293 {
294 MK_UNUSED auto fmtobj = getOBJN__null_allow();
295 MkRtSetup_O(fmtobj);
296 if (debug > (MK_DBG)(MkRuntimeGetDebug())) {return;}
297 MkLogVL(fmtobj, callfunc, debug, printfmt, var_list);
298 }