LibLcConfig_lc.h

Go to the documentation of this file.

 
/* LABEL-NO */
 
#pragma once
 
#ifdef META_STATIC
# include "private_mk.h"
#else
# include "LibMkKernel_mk.h"
#endif
 
#ifndef PARSE_C_HEADER_TO_META
  #include <string.h>
  #include "debug_mk.h"
#endif
 
__parser__(library=LcConfig@native@Lc@Config);
 
// MARK_D ################################################################
// -----------------------------------------------------------------------
// documentation order
 
// =========================================================================================
// Makefile:    CPPFLAGS definitions
 
// define:      META_STATIC
// reference:   META_STATIC from kernel_mk.h
 
#ifdef META_STATIC
# undef LC_C_BUILD_DLL
# define LC_C_BUILD_DLL
#endif
 
#if META_HAS_THREAD
#  define LC_RT_ARGS_ONLY         MK_RT mkrt
#  define LC_RT_ARGS              LC_RT_ARGS_ONLY,
#  define LC_RT_CALL_ONLY         mkrt
#  define LC_RT_CALL              LC_RT_CALL_ONLY,
#else
#  define LC_RT_ARGS_ONLY         void
#  define LC_RT_ARGS
#  define LC_RT_CALL_ONLY
#  define LC_RT_CALL
#endif
 
// +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
/* BEGIN_LC_C_DECLS should be used at the beginning of your declarations,
  so that C++ compilers don't mangle their names.  Use END_LC_C_DECLS at
  the end of C declarations. */
 
#undef BEGIN_LC_C_DECLS
#undef END_LC_C_DECLS
#if defined(META_COMPILE_AS_CC)
# define BEGIN_LC_C_DECLS namespace liblcconfig { using namespace libmkkernel;
# define END_LC_C_DECLS }
#elif defined(__cplusplus)
# define BEGIN_LC_C_DECLS extern "C" {
# define END_LC_C_DECLS }
#else
# define BEGIN_LC_C_DECLS /* empty */
# define END_LC_C_DECLS /* empty */
#endif
 
// MARK_O
#ifndef PARSE_C_HEADER_TO_META
# include "gen/config_overload_lc.h"
#endif
 
BEGIN_LC_C_DECLS
 
// +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
 
// ".c" file
# define LC_INSTANCE_HDL(x)         MK_INSTANCE_HDL(x)
 
# define LC_INSTANCE_RT_X(x)        MK_INSTANCE_RT_X(x)
# define LC_INSTANCE_RT_X_NULL(x)       MK_INSTANCE_RT_X_NULL(x)
# define LC_INSTANCE_RT_O(o)        MK_INSTANCE_RT_O(o)
# define LC_INSTANCE_RT_O_NULL(o)       MK_INSTANCE_RT_O_NULL(o)
# define LC_DESTRUCTOR_RT_X(c,x)    MK_DESTRUCTOR_RT_X(c,x)
# define LC_STATIC_RT               MK_STATIC_RT
 
// LcRuntimeC_C_API
 
// ==================================================================================
 
// BEGIN-HEADER - created by 'c_Class.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
// If the source of liblcconfig is direct used in an external library
// (without dynamic linking) and this library should *not* export
// the symbol's of liblcconfig then the flag META_IGNORE_EXTERN have
// to be set
#undef LC_EXTERN
#if defined(META_IGNORE_EXTERN)
#   define LC_EXTERN
#elif defined(PIC)
   // does we build a DLL ?
#  if defined(DLL_EXPORT)
       // does we build the liblcconfig library ?
#      if defined(LC_C_BUILD_DLL)
#        define LC_EXTERN __declspec(dllexport)
#      else
#        define LC_EXTERN __declspec(dllimport)
#      endif
#  else
   // no DLL - architecture specific extern specifier
#    define LC_EXTERN __attribute__ ((visibility("default")))
#  endif
#else
#   define LC_EXTERN
#endif
 
// external data lookup
#undef LC_EXTERN_DATA
#if defined(META_PRIVATE)
#  define LC_EXTERN_DATA extern
#elif defined(META_IGNORE_EXTERN)
#  define LC_EXTERN_DATA extern
#elif defined(PIC)
   // does we build a DLL ?
#  if defined(DLL_EXPORT)
       // does we build the liblcconfig library ?
#      if defined(LC_C_BUILD_DLL)
#        define LC_EXTERN_DATA __declspec(dllexport)
#      else
#        define LC_EXTERN_DATA __declspec(dllimport)
#      endif
#  else
   // no DLL - architecture specific extern specifier
#    define LC_EXTERN_DATA __attribute__ ((visibility("default"))) extern
#  endif
#else
#  define LC_EXTERN_DATA extern
#endif
 
// END-HEADER - created by 'c_Class.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
// LC_Compiler_C_API
 
/* ####################################################################### */
/* ###                                                                 ### */
/* ###                       START api definition                      ### */
/* ###                                                                 ### */
/* ####################################################################### */
 
// #######################################################################
// -----------------------------------------------------------------------
__parser__push__(no-rpc,template-overload,doc-group=Setup,prefix=Setup);
 
#ifndef META_COMPILE_AS_CC
__attribute__ ((constructor(200)))
#endif
__parser__(no-inline)
LC_EXTERN void MK_DECL LcSetup (void) MK_ATTR_STATIC ;
 
#ifndef META_COMPILE_AS_CC
__attribute__ ((destructor(200)))
#endif
__parser__(no-inline)
LC_EXTERN void MK_DECL LcCleanup (void) MK_ATTR_STATIC ;
 
__parser__pop__;
 
// LcConfig_Setup_C_API
 
// ==================================================================================
 
// ------------------------------------------------------------------
// mq_object from nat
 
#define LC_SET_T(_cls,_hook,_nat)   ({                                 \
  _cls##_type ret;                                                     \
  if ((_nat) == NULL) {                                                \
    ret = NULL;                                                        \
  } else {                                                             \
    ret = (_cls##_type)_hook (_nat);                                   \
    if (ret == NULL) {                                                 \
      ret = (_cls##_type) MkObjCreate(_cls##_TT,_nat,NULL);            \
    } else {                                                           \
      /* printV("reborn pointer class=%s value=%p\n",#_cls,ret); */    \
    }                                                                  \
  }                                                                    \
  ret;                                                                 \
})
 
struct LcConfigS;
struct LcSettingS;
 
// LcConfig_Type_C_API
 
// BEGIN-ShortDef - created by 'c_Class.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
  __parser__(type=ME_CCC_LcConfigC:"LcConfigC class handle":primary)
  typedef struct LcConfigS * LC_CFG;
  __parser__(type=ME_CCN_LcConfigC:"const - LcConfigC class handle":primary)
  typedef const struct LcConfigS * LC_CFGN;
  __parser__(ignore)
  typedef struct LcConfigS   LC_CFGR;
// LcConfigC_Class_C_API
 
  __parser__(type=ME_CCC_LcSettingC:"LcSettingC class handle":primary)
  typedef struct LcSettingS * LC_CFS;
  __parser__(type=ME_CCN_LcSettingC:"const - LcSettingC class handle":primary)
  typedef const struct LcSettingS * LC_CFSN;
  __parser__(ignore)
  typedef struct LcSettingS   LC_CFSR;
// LcSettingC_Class_C_API
 
// END-ShortDef - created by 'c_Class.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
// =======================================================================
 
END_LC_C_DECLS
#include "LcEnum_lc.h"
BEGIN_LC_C_DECLS
 
// =======================================================================
 
typedef enum LcErrorE LcErrorE;
 
typedef enum LcErrorTypeE LcErrorTypeE;
 
#define LcErrorCheckI(ret)   ((ret) == CONFIG_FALSE)
 
#define LcErrorE_Check(lc_hdl,PROC)                                  \
  if (unlikely(LcErrorCheckI(PROC))) {                              \
    LcConfigErrorToMQ(MkOBJ(lc_hdl), __func__,__FILE__,__LINE__);    \
    goto error;                                                      \
  }
 
// fix non common name
// example: (native code) config_error_t → (meta code) LcErrorE
// add new meta-name with: typedef config_error_t LcErrorE;
 
// ------------------------------------------------------------------
// error
 
__parser__(hide,overload-c-no,class=LcConfig,doc-group=Error,prefix=Error)
LC_EXTERN enum MkErrorE MK_DECL
LcConfigErrorToMQ (
  MK_OBJN const obj,
  MK_STRN const func     __parser__(default=F#FUNC)  ,
  MK_STRN const file     __parser__(default=F#FILE)  ,
  MK_I32  const line     __parser__(default=F#LINE)
) MK_ATTR_INSTANCE ;
 
 
/* ####################################################################### */
/* ###                                                                 ### */
/* ###                       I N C L U D E                             ### */
/* ###                                                                 ### */
/* ####################################################################### */
 
END_LC_C_DECLS
 
#ifndef META_DOXYGEN_SHOULD_SKIP_THIS
 
  #ifdef PARSE_C_HEADER_TO_META
    #include "libconfig_modified.h"
  #else
    #include "libconfig.h"
  #endif
 
  // BEGIN-Class-Include - created by 'c_Class.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
  #include "LcConfigC_lc.h"
  #include "LcSettingC_lc.h"
 
  // END-Class-Include - created by 'c_Class.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
#endif
 
BEGIN_LC_C_DECLS
 
/* ####################################################################### */
/* ###                                                                 ### */
/* ###                   P A C K A G E - A P I                         ### */
/* ###                                                                 ### */
/* ####################################################################### */
 
// ===========================================================================
__parser__global__(doc-force=LcConfig@Enum@local);
 
// =========================================================================
// BEGIN-LcConfig-fupu - created by 'c_Native.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
// -> no data
 
// END-LcConfig-fupu - created by 'c_Native.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
// =========================================================================
// BEGIN-LcConfig-inline - created by 'c_Native.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
// -> no data
 
// END-LcConfig-inline - created by 'c_Native.tcl -i NHI1_HOME/theConfig/c/gen/c_lcconfig.meta' - DO NOT change
 
 
__parser__push__(hide,no-rpc,doc-group=Setup,prefix=Setup);
 
typedef void ( MK_DECL *LcSetupThreadF ) ( MK_RT_ARGS_ONLY );
 
LC_EXTERN void MK_DECL LcSetupThreadCallback ( LcSetupThreadF call ) MK_ATTR_STATIC ;
 
__parser__pop__;
 
 
/*****************************************************************************/
/*                                                                           */
/*                                  check                                    */
/* (macros used in typeS functions)                                          */
/*****************************************************************************/
 
#define LcErrorC_Check(hdl,PROC)          \
  if (unlikely(LcErrorCheckI(PROC))) {    \
    OT_ERROR_LC_2_MQ(hdl);                \
    OT_ERROR_META_2_LNG(hdl);               \
    goto error;                           \
  }
 
#define OT_ERROR_LC_2_MQ(hdl)         LcConfigErrorToMQ(MkOBJ(hdl), __func__,__FILE__,__LINE__);
 
END_LC_C_DECLS