CmnLog.h

[詳解]

#ifndef CMNCLIB_CMN_LOG_H
#define CMNCLIB_CMN_LOG_H

#include <time.h>
#include <stdarg.h>

#include "cmnclib/Common.h"
#include "cmnclib/CmnThread.h"


typedef struct tag_CmnLogMessage {
    char *code;                         
    char *msg;                          
    struct tag_CmnLogMessage *next; 
} CmnLogMessage;

typedef struct tag_CmnLogEx {
    int level;              
    char *file;             
    CmnLogMessage *list;    
    CmnThreadMutex* mutex;  
} CmnLogEx;

typedef enum {
    CMN_LOG_LEVEL_NOTHING,     
    CMN_LOG_LEVEL_ERROR,       
    CMN_LOG_LEVEL_WARN,        
    CMN_LOG_LEVEL_INFO,        
    CMN_LOG_LEVEL_DEBUG,       
    CMN_LOG_LEVEL_TRACE,       
    CMN_LOG_LEVEL_MAX = CMN_LOG_LEVEL_TRACE  
} CMN_LOG_LEVEL;

/* --- CmnLog.c --- */
/* 標準ログ出力関数初期化処理 */
D_EXTERN int CmnLog_Init(const char* logFile, CMN_LOG_LEVEL level, const char* msgFile);
/* 標準ログ出力共通関数終了処理 */
D_EXTERN void CmnLog_End();
/* 標準ログ出力（メッセージ指定） */
D_EXTERN void CmnLog_Put(int level, const char *msgCode, ...);
/* 標準ログ出力（メッセージコード指定） */
D_EXTERN void CmnLog_PutByCode(CmnLogEx* log, CMN_LOG_LEVEL level, const char* msgCode, ...);
/* cmn-clibの内部ログ出力設定 */
D_EXTERN void CmnLog_InitCmnClibLog(CmnLogEx *log, CMN_LOG_LEVEL level);
/* cmn-clibの内部ログ出力終了 */
D_EXTERN void CmnLog_EndCmnClibLog();
/* cmn-clibの内部ログ出力 */
D_EXTERN void CmnLog_PutCmnClibLog(CMN_LOG_LEVEL level, const char* msgCode, ...);

/* --- CmnLogEx.c --- */
/* 拡張ログ出力関数初期化処理 */
D_EXTERN CmnLogEx* CmnLogEx_Create(const char* logFile, CMN_LOG_LEVEL level, const char* msgFile);
/* 拡張ログ出力共通関数終了処理 */
D_EXTERN void CmnLogEx_Free(CmnLogEx *log);
/* 拡張ログ出力（メッセージ指定） */
D_EXTERN void CmnLogEx_Put(CmnLogEx* log, CMN_LOG_LEVEL level, const char* msg, ...);
/* 拡張ログ出力（メッセージコード指定） */
D_EXTERN void CmnLogEx_PutByCode(CmnLogEx* log, CMN_LOG_LEVEL level, const char* msgCode, ...);
/* 拡張ログ出力（ログ出力共通） */
D_EXTERN void cmnLogEx_PutLog(CmnLogEx* log, CMN_LOG_LEVEL level, const char* msg, va_list args);

/* --- CmnLogMessage.c --- */
/* ログメッセージ定義ファイル読み込み */
D_EXTERN CmnLogMessage* CmnLogMessage_Create(const char* msgFile);
/* ログメッセージリスト解放処理 */
D_EXTERN void CmnLogMessage_Free(CmnLogMessage* list);
/* ログメッセージ取得関数 */
D_EXTERN int CmnLogMessage_Get(CmnLogMessage* list, const char* msg_code, CmnLogMessage* msg);

/* cmn-clib内部ログ出力ラッパーマクロ */
#ifdef CMN_CLIB_HI_PERFORMANCE
    #define CMNLOG_TRACE_START()
    #define CMNLOG_TRACE_END()
#else
    #define CMNLOG_TRACE_START() clock_t cmnlogtrace_stclock=clock();CmnLog_PutCmnClibLog(CMN_LOG_LEVEL_TRACE, "START %s", __func__)
    #define CMNLOG_TRACE_END() CmnLog_PutCmnClibLog(CMN_LOG_LEVEL_TRACE, "END %s(clocks=%d)", __func__, clock() - cmnlogtrace_stclock)
#endif
#define CMNLOG_TRACE(msg, ...) CmnLog_PutCmnClibLog(CMN_LOG_LEVEL_TRACE, (msg), __VA_ARGS__)
#define CMNLOG_DEBUG(msg, ...) CmnLog_PutCmnClibLog(CMN_LOG_LEVEL_DEBUG, (msg), __VA_ARGS__)
#define CMNLOG_INFO(msg, ...) CmnLog_PutCmnClibLog(CMN_LOG_LEVEL_INFO, (msg), __VA_ARGS__)
#define CMNLOG_WARN(msg, ...) CmnLog_PutCmnClibLog(CMN_LOG_LEVEL_WARN, (msg), __VA_ARGS__)
#define CMNLOG_ERROR(msg, ...) CmnLog_PutCmnClibLog(CMN_LOG_LEVEL_ERROR, (msg), __VA_ARGS__)

#endif /* CMNCLIB_CMN_LOG_H */