afw_debug.h

Go to the documentation of this file.

//>>> See COPYING at repository root
/*
 * Adaptive Framework Software Debug Header
 *
 * Copyright (c) 2010-2023 Clemson University
 *
 */
 
#ifndef __AFW_DEBUG_H__
#define __AFW_DEBUG_H__
 
#include "afw_interface.h"
 
AFW_BEGIN_DECLARES
 
#define AFW_DEBUG_STATIC_DEBUG_ID(label, debug_id) \
static const afw_interface_implementation_rti_t label = \
    {"afw_debug_id", __FILE__, debug_id};
 
 
#define afw_debug(flag_index, instance, message, xctx) \
    if ((flag_index) < (xctx)->flags_count && (xctx)->flags[flag_index]) \
        afw_debug_write( \
            ((instance) ? \
                &((const afw_instance_t *)instance)->inf->rti \
                : NULL), \
            AFW__FILE_LINE__, message, xctx)
 
 
#define afw_debug_fz(flag_index, instance, xctx, format_z, ...) \
    if ((flag_index) < (xctx)->flags_count && (xctx)->flags[flag_index]) \
        afw_debug_write_fz( \
            ((instance) ? \
                &((const afw_instance_t *)instance)->inf->rti \
                : NULL), \
            AFW__FILE_LINE__, xctx, format_z, __VA_ARGS__)
    /*
        afw_debug_write_fz( \
            (instance) ? &(instance)->inf->rti : NULL, \
            AFW__FILE_LINE__, xctx, format_z, __VA_ARGS__)
    */
 
 
 
#define afw_debug_vz(flag_index, instance, format_z, ap, xctx) \
    if ((flag_index) < (xctx)->flags_count && (xctx)->flags[flag_index]) \
        afw_debug_write_vz( \
            ((instance) ? \
                &((const afw_instance_t *)instance)->inf->rti \
                : NULL), \
            AFW__FILE_LINE__, format_z, ap, xctx)
 
 
#define afw_debug_z(flag_index, instance, message_z, xctx) \
    if ((flag_index) < (xctx)->flags_count && (xctx)->flags[flag_index]) \
        afw_debug_write_z( \
            ((instance) ? \
                &((const afw_instance_t *)instance)->inf->rti \
                : NULL), \
            AFW__FILE_LINE__, message_z, xctx)
 
 
AFW_DECLARE(void)
afw_debug_write(
    const afw_interface_implementation_rti_t *rti,
    const afw_utf8_z_t *source_z,
    const afw_utf8_t *message,
    afw_xctx_t *xctx);
 
 
AFW_DECLARE(void)
afw_debug_write_fz(
    const afw_interface_implementation_rti_t *rti,
    const afw_utf8_z_t *source_z,
    afw_xctx_t *xctx,
    const afw_utf8_z_t *format_z,
    ...);
 
 
AFW_DECLARE(void)
afw_debug_write_vz(
    const afw_interface_implementation_rti_t *rti,
    const afw_utf8_z_t *source_z,
    const afw_utf8_z_t *format_z,
    va_list ap,
    afw_xctx_t *xctx);
 
 
AFW_DECLARE(void)
afw_debug_write_z(
    const afw_interface_implementation_rti_t *rti,
    const afw_utf8_z_t *source_z,
    const afw_utf8_z_t *message_z,
    afw_xctx_t *xctx);
 
 
AFW_END_DECLARES
 
#endif /* __AFW_DEBUG_H__ */