MkObjectC_Log_ATL_API

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

Collaboration diagram for MkObjectC_Log_ATL_API:

Functions
static OT_ProcRet	atlmkkernel_MkObjectC_LogC (MkObjectC_ARGS)
	Atl: MkObjectC::LogC $fmtobj message:string ?debug:int32=0? ?callfunc:string="MK_NULL"? → C-API write a logging-message to MkLogFileC (default: stderr) using the internal format …
static OT_ProcRet	atlmkkernel_MkObjectC_LogHEX (MkObjectC_ARGS)
	Atl: MkObjectC::LogHEX $fmtobj callfunc:string data:binary → C-API log binaray data as HEX into the MkLogFileC (default: stderr) …
static OT_ProcRet	atlmkkernel_MkObjectC_Log (MkObjectC_ARGS)
	Atl: MkObjectC::Log $obj ?fmtobj:MkObjectC=NULL? ?debug:int32=0? ?callfunc:string="MK_NULL"? ?lvl:int32=0? → C-API Log-Slot - log a summary of an object to the MkLogFileC (default: stderr) target …
static OT_ProcRet	atlmkkernel_MkObjectC_LogLong (MkObjectC_ARGS)
	Atl: MkObjectC::LogLong $obj ?fmtobj:MkObjectC=NULL? ?debug:int32=0? ?callfunc:string="MK_NULL"? ?lvl:int32=0? → C-API log the MkObjectS verbose into the MkLogFileC (default: stderr) …
static OT_ProcRet	atlmkkernel_MkObjectC_LogShort (MkObjectC_ARGS)
	Atl: MkObjectC::LogShort $obj ?fmtobj:MkObjectC=NULL? ?debug:int32=0? ?callfunc:string="MK_NULL"? ?lvl:int32=0? → C-API log the MkObjectS into the MkLogFileC (default: stderr) …
static OT_ProcRet	atlmkkernel_MkObjectC_LogType (MkObjectC_ARGS)
	Atl: MkObjectC::LogType $obj ?fmtobj:MkObjectC=NULL? ?debug:int32=0? ?callfunc:string="MK_NULL"? ?lvl:int32=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="MK_NULL" → use default-format)
[in]	callfunc	a user-defined postfix to identify the calling-function or the environment (default = name-of-function, "MK_NULL" = resolve-own-name)
[in]	debug	the debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0)

Function Documentation

atlmkkernel_MkObjectC_Log()

static OT_ProcRet atlmkkernel_MkObjectC_Log ( MkObjectC_ARGS )

static

Atl: MkObjectC::Log $obj ?fmtobj:MkObjectC=NULL? ?debug:int32=0? ?callfunc:string="MK_NULL"? ?lvl:int32=0? → C-API
Log-Slot - log a summary of an object to the MkLogFileC (default: stderr) target …

Definition at line 585 of file MkObjectC_atl.c.

                                                     {
  OT_SETUP_hdl;
  OT_SETUP_VARARGS(0,4,Log_doc);
  MK_OBJN fmtobj = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_OBJN (fmtobj,MK_NULL_YES))
  MK_DBG debug = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (debug))
  MK_STRN callfunc = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_STRN (callfunc))
  MK_I32 lvl = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (lvl))
  OT_CHECK_NOARGS;
  if (debug > MkRuntimeDebugGet()) {
    OT_retObj_SET_None;
    goto end;
  }
  if (MkSysStringIsNULL(callfunc)) {callfunc = OT_GET_CALL_PROC;}
  MkObjectLog (hdl, fmtobj, debug, callfunc, lvl);
  OT_retObj_SET_None;
  goto end;
  error:
  OT_retObj_SET_Error;
  end:
  OT_FRAME_CLEANUP;
  OT_retObj_RETURN;
}

atlmkkernel_MkObjectC_LogC()

static OT_ProcRet atlmkkernel_MkObjectC_LogC ( MkObjectC_ARGS )

static

Atl: MkObjectC::LogC $fmtobj message:string ?debug:int32=0? ?callfunc:string="MK_NULL"? → C-API
write a logging-message to MkLogFileC (default: stderr) using the internal format …

Definition at line 539 of file MkObjectC_atl.c.

                                                      {
  OT_SETUP_hdl__null_allow;
  OT_SETUP_VARARGS(1,3,LogC_doc);
  MK_STRN message = 0;
  OT_CHECK_REQUIRED(OT_CHECK_STRN (message))
  MK_DBG debug = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (debug))
  MK_STRN callfunc = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_STRN (callfunc))
  OT_CHECK_NOARGS;
  if (debug > MkRuntimeDebugGet()) {
    OT_retObj_SET_None;
    goto end;
  }
  if (MkSysStringIsNULL(callfunc)) {callfunc = OT_GET_CALL_PROC;}
  MkLogC (hdl, message, debug, callfunc);
  OT_retObj_SET_None;
  goto end;
  error:
  OT_retObj_SET_Error;
  end:
  OT_FRAME_CLEANUP;
  OT_retObj_RETURN;
}

atlmkkernel_MkObjectC_LogHEX()

static OT_ProcRet atlmkkernel_MkObjectC_LogHEX ( MkObjectC_ARGS )

static

Atl: MkObjectC::LogHEX $fmtobj callfunc:string data:binary → C-API
log binaray data as HEX into the MkLogFileC (default: stderr) …

Definition at line 565 of file MkObjectC_atl.c.

                                                        {
  OT_SETUP_hdl__null_allow;
  OT_SETUP_VARARGS(1,2,LogHEX_doc);
  MK_STRN callfunc = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_STRN (callfunc))
  MkBinaryR data = {0};
  OT_CHECK_REQUIRED(OT_CHECK__ME_REF_MkBinaryR(data))
  OT_CHECK_NOARGS;
  if (MkSysStringIsNULL(callfunc)) {callfunc = OT_GET_CALL_PROC;}
  MkLogHEX (hdl, callfunc, data);
  OT_retObj_SET_None;
  goto end;
  error:
  OT_retObj_SET_Error;
  end:
  OT_FRAME_CLEANUP;
  OT_retObj_RETURN;
}

atlmkkernel_MkObjectC_LogLong()

static OT_ProcRet atlmkkernel_MkObjectC_LogLong ( MkObjectC_ARGS )

static

Atl: MkObjectC::LogLong $obj ?fmtobj:MkObjectC=NULL? ?debug:int32=0? ?callfunc:string="MK_NULL"? ?lvl:int32=0? → C-API
log the MkObjectS verbose into the MkLogFileC (default: stderr) …

Definition at line 613 of file MkObjectC_atl.c.

                                                         {
  OT_SETUP_hdl;
  OT_SETUP_VARARGS(0,4,LogLong_doc);
  MK_OBJN fmtobj = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_OBJN (fmtobj,MK_NULL_YES))
  MK_DBG debug = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (debug))
  MK_STRN callfunc = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_STRN (callfunc))
  MK_I32 lvl = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (lvl))
  OT_CHECK_NOARGS;
  if (debug > MkRuntimeDebugGet()) {
    OT_retObj_SET_None;
    goto end;
  }
  if (MkSysStringIsNULL(callfunc)) {callfunc = OT_GET_CALL_PROC;}
  MkObjectLogLong (hdl, fmtobj, debug, callfunc, lvl);
  OT_retObj_SET_None;
  goto end;
  error:
  OT_retObj_SET_Error;
  end:
  OT_FRAME_CLEANUP;
  OT_retObj_RETURN;
}

atlmkkernel_MkObjectC_LogShort()

static OT_ProcRet atlmkkernel_MkObjectC_LogShort ( MkObjectC_ARGS )

static

Atl: MkObjectC::LogShort $obj ?fmtobj:MkObjectC=NULL? ?debug:int32=0? ?callfunc:string="MK_NULL"? ?lvl:int32=0? → C-API
log the MkObjectS into the MkLogFileC (default: stderr) …

Definition at line 641 of file MkObjectC_atl.c.

                                                          {
  OT_SETUP_hdl;
  OT_SETUP_VARARGS(0,4,LogShort_doc);
  MK_OBJN fmtobj = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_OBJN (fmtobj,MK_NULL_YES))
  MK_DBG debug = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (debug))
  MK_STRN callfunc = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_STRN (callfunc))
  MK_I32 lvl = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (lvl))
  OT_CHECK_NOARGS;
  if (debug > MkRuntimeDebugGet()) {
    OT_retObj_SET_None;
    goto end;
  }
  if (MkSysStringIsNULL(callfunc)) {callfunc = OT_GET_CALL_PROC;}
  MkObjectLogShort (hdl, fmtobj, debug, callfunc, lvl);
  OT_retObj_SET_None;
  goto end;
  error:
  OT_retObj_SET_Error;
  end:
  OT_FRAME_CLEANUP;
  OT_retObj_RETURN;
}

atlmkkernel_MkObjectC_LogType()

static OT_ProcRet atlmkkernel_MkObjectC_LogType ( MkObjectC_ARGS )

static

Atl: MkObjectC::LogType $obj ?fmtobj:MkObjectC=NULL? ?debug:int32=0? ?callfunc:string="MK_NULL"? ?lvl:int32=0? → C-API
log the tyoe of the MkObjectS into the MkLogFileC (default: stderr) …

Definition at line 669 of file MkObjectC_atl.c.

                                                         {
  OT_SETUP_hdl;
  OT_SETUP_VARARGS(0,4,LogType_doc);
  MK_OBJN fmtobj = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_OBJN (fmtobj,MK_NULL_YES))
  MK_DBG debug = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (debug))
  MK_STRN callfunc = NULL;
  OT_CHECK_OPTIONAL(OT_CHECK_STRN (callfunc))
  MK_I32 lvl = 0;
  OT_CHECK_OPTIONAL(OT_CHECK_NI4 (lvl))
  OT_CHECK_NOARGS;
  if (debug > MkRuntimeDebugGet()) {
    OT_retObj_SET_None;
    goto end;
  }
  if (MkSysStringIsNULL(callfunc)) {callfunc = OT_GET_CALL_PROC;}
  MkObjectLogType (hdl, fmtobj, debug, callfunc, lvl);
  OT_retObj_SET_None;
  goto end;
  error:
  OT_retObj_SET_Error;
  end:
  OT_FRAME_CLEANUP;
  OT_retObj_RETURN;
}