log_macros.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include "log_functions.h"
 
// =============================================================================
// Variadic Macro Dispatch Helpers
// =============================================================================
 
// Argument counter: returns 2 for 2+ args, 1 for 1 arg
#define KCENON_LOG_ARG_COUNT(...) \
    KCENON_LOG_ARG_COUNT_IMPL(__VA_ARGS__, 2, 1)
#define KCENON_LOG_ARG_COUNT_IMPL(_1, _2, N, ...) N
 
// Token paste helpers for macro dispatch
#define KCENON_LOG_PASTE(a, b) KCENON_LOG_PASTE_IMPL(a, b)
#define KCENON_LOG_PASTE_IMPL(a, b) a##b
 
// Dispatch macro: calls LEVEL_1 or LEVEL_2 based on argument count
#define KCENON_LOG_DISPATCH(LEVEL, ...) \
    KCENON_LOG_PASTE(LEVEL##_, KCENON_LOG_ARG_COUNT(__VA_ARGS__))(__VA_ARGS__)
 
// =============================================================================
// Primary LOG_* Macros (Unified Variadic Interface)
// =============================================================================
 
#define LOG_TRACE(...) KCENON_LOG_DISPATCH(LOG_TRACE, __VA_ARGS__)
#define LOG_TRACE_1(msg) \
    ::kcenon::common::logging::log_trace(msg)
#define LOG_TRACE_2(logger_name, msg) \
    ::kcenon::common::logging::log_trace_to(logger_name, msg)
 
#define LOG_DEBUG(...) KCENON_LOG_DISPATCH(LOG_DEBUG, __VA_ARGS__)
#define LOG_DEBUG_1(msg) \
    ::kcenon::common::logging::log_debug(msg)
#define LOG_DEBUG_2(logger_name, msg) \
    ::kcenon::common::logging::log_debug_to(logger_name, msg)
 
#define LOG_INFO(...) KCENON_LOG_DISPATCH(LOG_INFO, __VA_ARGS__)
#define LOG_INFO_1(msg) \
    ::kcenon::common::logging::log_info(msg)
#define LOG_INFO_2(logger_name, msg) \
    ::kcenon::common::logging::log_info_to(logger_name, msg)
 
#define LOG_WARNING(...) KCENON_LOG_DISPATCH(LOG_WARNING, __VA_ARGS__)
#define LOG_WARNING_1(msg) \
    ::kcenon::common::logging::log_warning(msg)
#define LOG_WARNING_2(logger_name, msg) \
    ::kcenon::common::logging::log_warning_to(logger_name, msg)
 
#define LOG_ERROR(...) KCENON_LOG_DISPATCH(LOG_ERROR, __VA_ARGS__)
#define LOG_ERROR_1(msg) \
    ::kcenon::common::logging::log_error(msg)
#define LOG_ERROR_2(logger_name, msg) \
    ::kcenon::common::logging::log_error_to(logger_name, msg)
 
#define LOG_CRITICAL(...) KCENON_LOG_DISPATCH(LOG_CRITICAL, __VA_ARGS__)
#define LOG_CRITICAL_1(msg) \
    ::kcenon::common::logging::log_critical(msg)
#define LOG_CRITICAL_2(logger_name, msg) \
    ::kcenon::common::logging::log_critical_to(logger_name, msg)
 
// =============================================================================
// Conditional Logging Macros
// =============================================================================
 
#define LOG_IF(level, msg) \
    do { \
        if (::kcenon::common::logging::is_enabled(level)) { \
            ::kcenon::common::logging::log(level, msg); \
        } \
    } while (0)
 
#define LOG_IF_TO(level, logger_name, msg) \
    do { \
        if (::kcenon::common::logging::is_enabled(level, logger_name)) { \
            ::kcenon::common::logging::log(level, msg, logger_name); \
        } \
    } while (0)
 
// =============================================================================
// Utility Macros
// =============================================================================
 
#define LOG_FLUSH() \
    ::kcenon::common::logging::flush()
 
#define LOG_FLUSH_TO(logger_name) \
    ::kcenon::common::logging::flush(logger_name)
 
#define LOG_IS_ENABLED(level) \
    ::kcenon::common::logging::is_enabled(level)
 
#define LOG_IS_ENABLED_FOR(level, logger_name) \
    ::kcenon::common::logging::is_enabled(level, logger_name)
 
// =============================================================================
// Compile-time Log Level Control (Optional)
// =============================================================================
 
#ifndef KCENON_MIN_LOG_LEVEL
    #define KCENON_MIN_LOG_LEVEL 0
#endif
 
// Redefine macros if compile-time level filtering is enabled
// Each level is disabled when KCENON_MIN_LOG_LEVEL exceeds its threshold
// Note: variadic LOG_* macros are replaced with no-op when compile-time level filtering is enabled
#if KCENON_MIN_LOG_LEVEL > 0  // threshold: trace = 0
    #undef LOG_TRACE
    #define LOG_TRACE(...) ((void)0)
#endif
 
#if KCENON_MIN_LOG_LEVEL > 1  // threshold: debug = 1
    #undef LOG_DEBUG
    #define LOG_DEBUG(...) ((void)0)
#endif
 
#if KCENON_MIN_LOG_LEVEL > 2  // threshold: info = 2
    #undef LOG_INFO
    #define LOG_INFO(...) ((void)0)
#endif
 
#if KCENON_MIN_LOG_LEVEL > 3  // threshold: warning = 3
    #undef LOG_WARNING
    #define LOG_WARNING(...) ((void)0)
#endif
 
#if KCENON_MIN_LOG_LEVEL > 4  // threshold: error = 4
    #undef LOG_ERROR
    #define LOG_ERROR(...) ((void)0)
#endif
 
#if KCENON_MIN_LOG_LEVEL > 5  // threshold: critical = 5
    #undef LOG_CRITICAL
    #define LOG_CRITICAL(...) ((void)0)
#endif