edelib/Debug.h

/*
 * $Id: Debug.h 2614 2009-03-30 15:10:53Z karijes $
 *
 * Debug functions
 * Copyright (c) 2005-2007 edelib authors
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library. If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef __EDELIB_DEBUG_H__
#define __EDELIB_DEBUG_H__

#include "edelib-global.h"

#ifndef E_LOG_DOMAIN
        #define E_LOG_DOMAIN ((char*)0)
#endif

/* these functions are not in the namespace so we don't get * strange output with the preprocessor */
EDELIB_API void _edelib_debug(const char* fmt, ...);
EDELIB_API void _edelib_warning(const char* fmt, ...);
EDELIB_API void _edelib_assert(int cond, const char* cond_text, const char* file, int line, const char* func);
EDELIB_API void _edelib_fatal(const char* fmt, ...);

#ifdef __GNUC__
        #define _E_FUNCTION_NAME __PRETTY_FUNCTION__
#else
        #define _E_FUNCTION_NAME "<unknown>"
#endif

#ifdef NDEBUG
        #define E_ASSERT(expr)
#else
        #define E_ASSERT(expr) _edelib_assert((expr) != 0, #expr, __FILE__, __LINE__, _E_FUNCTION_NAME)
#endif

#define E_DEBUG   _edelib_debug

#define E_WARNING _edelib_warning

#define E_FATAL   _edelib_fatal

#define _E_STRLOC_STRINGIFY(arg)          _E_STRLOC_STRINGIFY_ARG(arg)
#define _E_STRLOC_STRINGIFY_ARG(content)  #content

#define E_STRLOC __FILE__ ":" _E_STRLOC_STRINGIFY(__LINE__)

#if defined(__GNUC__) && (__GNUC__ > 2) && defined(__OPTIMIZE__)
        #define _E_BOOLEAN_EXPR(expr)         \
        __extension__ ({                      \
                        int _edelib_boolean_var_;     \
                        if(expr)                      \
                                _edelib_boolean_var_ = 1; \
                        else                          \
                                _edelib_boolean_var_ = 0; \
                        _edelib_boolean_var_;         \
        })

        #define E_LIKELY(expr)   (__builtin_expect(_E_BOOLEAN_EXPR(expr), 1))
        #define E_UNLIKELY(expr) (__builtin_expect(_E_BOOLEAN_EXPR(expr), 0))
#else
        #define E_LIKELY(expr)   (expr)
        #define E_UNLIKELY(expr) (expr)
#endif

#define E_RETURN_IF_FAIL(expr)                                      \
        do {                                                            \
                if E_LIKELY(expr) { }                                       \
                else {                                                      \
                        E_WARNING(E_STRLOC ": Condition '%s' failed\n", #expr); \
                        return;                                                 \
                }                                                           \
        } while(0)                 

#define E_RETURN_VAL_IF_FAIL(expr, val)                             \
        do {                                                            \
                if E_LIKELY(expr) { }                                       \
                else {                                                      \
                        E_WARNING(E_STRLOC ": Condition '%s' failed\n", #expr); \
                        return (val);                                           \
                }                                                           \
        } while(0)


/* compatibility with the old code */
#define EDEBUG   E_DEBUG
#define EWARNING E_WARNING
#define EFATAL   E_FATAL
#define EASSERT  E_ASSERT
#define ESTRLOC  E_STRLOC

EDELIB_NS_BEGIN

enum ErrorMessageType {
        ERROR_MESSAGE_DEBUG,      
        ERROR_MESSAGE_WARNING,    
        ERROR_MESSAGE_FATAL       
};

EDELIB_API void error_mesage_handler_install(void (*)(ErrorMessageType t, const char* msg));

EDELIB_NS_END
#endif

---