[pcsx_rearmed.git] / deps / libchdr / deps / zstd-1.5.6 / lib / common / debug.h

/* ******************************************************************
 * debug
 * Part of FSE library
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * You can contact the author at :
 * - Source repository : https://github.com/Cyan4973/FiniteStateEntropy
 *
 * This source code is licensed under both the BSD-style license (found in the
 * LICENSE file in the root directory of this source tree) and the GPLv2 (found
 * in the COPYING file in the root directory of this source tree).
 * You may select, at your option, one of the above-listed licenses.
****************************************************************** */


/*
 * The purpose of this header is to enable debug functions.
 * They regroup assert(), DEBUGLOG() and RAWLOG() for run-time,
 * and DEBUG_STATIC_ASSERT() for compile-time.
 *
 * By default, DEBUGLEVEL==0, which means run-time debug is disabled.
 *
 * Level 1 enables assert() only.
 * Starting level 2, traces can be generated and pushed to stderr.
 * The higher the level, the more verbose the traces.
 *
 * It's possible to dynamically adjust level using variable g_debug_level,
 * which is only declared if DEBUGLEVEL>=2,
 * and is a global variable, not multi-thread protected (use with care)
 */

#ifndef DEBUG_H_12987983217
#define DEBUG_H_12987983217

#if defined (__cplusplus)
extern "C" {
#endif


/* static assert is triggered at compile time, leaving no runtime artefact.
 * static assert only works with compile-time constants.
 * Also, this variant can only be used inside a function. */
#define DEBUG_STATIC_ASSERT(c) (void)sizeof(char[(c) ? 1 : -1])


/* DEBUGLEVEL is expected to be defined externally,
 * typically through compiler command line.
 * Value must be a number. */
#ifndef DEBUGLEVEL
#  define DEBUGLEVEL 0
#endif


/* recommended values for DEBUGLEVEL :
 * 0 : release mode, no debug, all run-time checks disabled
 * 1 : enables assert() only, no display
 * 2 : reserved, for currently active debug path
 * 3 : events once per object lifetime (CCtx, CDict, etc.)
 * 4 : events once per frame
 * 5 : events once per block
 * 6 : events once per sequence (verbose)
 * 7+: events at every position (*very* verbose)
 *
 * It's generally inconvenient to output traces > 5.
 * In which case, it's possible to selectively trigger high verbosity levels
 * by modifying g_debug_level.
 */

#if (DEBUGLEVEL>=1)
#  define ZSTD_DEPS_NEED_ASSERT
#  include "zstd_deps.h"
#else
#  ifndef assert   /* assert may be already defined, due to prior #include <assert.h> */
#    define assert(condition) ((void)0)   /* disable assert (default) */
#  endif
#endif

#if (DEBUGLEVEL>=2)
#  define ZSTD_DEPS_NEED_IO
#  include "zstd_deps.h"
extern int g_debuglevel; /* the variable is only declared,
                            it actually lives in debug.c,
                            and is shared by the whole process.
                            It's not thread-safe.
                            It's useful when enabling very verbose levels
                            on selective conditions (such as position in src) */

#  define RAWLOG(l, ...)                   \
    do {                                   \
        if (l<=g_debuglevel) {             \
            ZSTD_DEBUG_PRINT(__VA_ARGS__); \
        }                                  \
    } while (0)

#define STRINGIFY(x) #x
#define TOSTRING(x) STRINGIFY(x)
#define LINE_AS_STRING TOSTRING(__LINE__)

#  define DEBUGLOG(l, ...)                               \
    do {                                                 \
        if (l<=g_debuglevel) {                           \
            ZSTD_DEBUG_PRINT(__FILE__ ":" LINE_AS_STRING ": " __VA_ARGS__); \
            ZSTD_DEBUG_PRINT(" \n");                     \
        }                                                \
    } while (0)
#else
#  define RAWLOG(l, ...)   do { } while (0)    /* disabled */
#  define DEBUGLOG(l, ...) do { } while (0)    /* disabled */
#endif


#if defined (__cplusplus)
}
#endif

#endif /* DEBUG_H_12987983217 */
Commit	Line	Data
648db22b	1	/* ******************************************************************
	2	* debug
	3	* Part of FSE library
	4	* Copyright (c) Meta Platforms, Inc. and affiliates.
	5	*
	6	* You can contact the author at :
	7	* - Source repository : https://github.com/Cyan4973/FiniteStateEntropy
	8	*
	9	* This source code is licensed under both the BSD-style license (found in the
	10	* LICENSE file in the root directory of this source tree) and the GPLv2 (found
	11	* in the COPYING file in the root directory of this source tree).
	12	* You may select, at your option, one of the above-listed licenses.
	13	****************************************************************** */
	14
	15
	16	/*
	17	* The purpose of this header is to enable debug functions.
	18	* They regroup assert(), DEBUGLOG() and RAWLOG() for run-time,
	19	* and DEBUG_STATIC_ASSERT() for compile-time.
	20	*
	21	* By default, DEBUGLEVEL==0, which means run-time debug is disabled.
	22	*
	23	* Level 1 enables assert() only.
	24	* Starting level 2, traces can be generated and pushed to stderr.
	25	* The higher the level, the more verbose the traces.
	26	*
	27	* It's possible to dynamically adjust level using variable g_debug_level,
	28	* which is only declared if DEBUGLEVEL>=2,
	29	* and is a global variable, not multi-thread protected (use with care)
	30	*/
	31
	32	#ifndef DEBUG_H_12987983217
	33	#define DEBUG_H_12987983217
	34
	35	#if defined (__cplusplus)
	36	extern "C" {
	37	#endif
	38
	39
	40	/* static assert is triggered at compile time, leaving no runtime artefact.
	41	* static assert only works with compile-time constants.
	42	* Also, this variant can only be used inside a function. */
	43	#define DEBUG_STATIC_ASSERT(c) (void)sizeof(char[(c) ? 1 : -1])
	44
	45
	46	/* DEBUGLEVEL is expected to be defined externally,
	47	* typically through compiler command line.
	48	* Value must be a number. */
	49	#ifndef DEBUGLEVEL
	50	# define DEBUGLEVEL 0
	51	#endif
	52
	53
	54	/* recommended values for DEBUGLEVEL :
	55	* 0 : release mode, no debug, all run-time checks disabled
	56	* 1 : enables assert() only, no display
	57	* 2 : reserved, for currently active debug path
	58	* 3 : events once per object lifetime (CCtx, CDict, etc.)
	59	* 4 : events once per frame
	60	* 5 : events once per block
	61	* 6 : events once per sequence (verbose)
	62	* 7+: events at every position (very verbose)
	63	*
	64	* It's generally inconvenient to output traces > 5.
65	* In which case, it's possible to selectively trigger high verbosity levels
66	* by modifying g_debug_level.
67	*/
68
69	#if (DEBUGLEVEL>=1)
70	# define ZSTD_DEPS_NEED_ASSERT
71	# include "zstd_deps.h"
72	#else
73	# ifndef assert /* assert may be already defined, due to prior #include <assert.h> */
74	# define assert(condition) ((void)0) /* disable assert (default) */
75	# endif
76	#endif
77
78	#if (DEBUGLEVEL>=2)
79	# define ZSTD_DEPS_NEED_IO
80	# include "zstd_deps.h"
81	extern int g_debuglevel; /* the variable is only declared,
82	it actually lives in debug.c,
83	and is shared by the whole process.
84	It's not thread-safe.
85	It's useful when enabling very verbose levels
86	on selective conditions (such as position in src) */
87
f535537f	88	# define RAWLOG(l, ...) \
	89	do { \
	90	if (l<=g_debuglevel) { \
	91	ZSTD_DEBUG_PRINT(__VA_ARGS__); \
	92	} \
	93	} while (0)
	94
	95	#define STRINGIFY(x) #x
	96	#define TOSTRING(x) STRINGIFY(x)
	97	#define LINE_AS_STRING TOSTRING(__LINE__)
	98
	99	# define DEBUGLOG(l, ...) \
	100	do { \
	101	if (l<=g_debuglevel) { \
	102	ZSTD_DEBUG_PRINT(__FILE__ ":" LINE_AS_STRING ": " __VA_ARGS__); \
	103	ZSTD_DEBUG_PRINT(" \n"); \
	104	} \
	105	} while (0)
648db22b	106	#else
f535537f	107	# define RAWLOG(l, ...) do { } while (0) /* disabled */
f535537f	108	# define DEBUGLOG(l, ...) do { } while (0) /* disabled */
648db22b	109	#endif
	110
	111
	112	#if defined (__cplusplus)
	113	}
	114	#endif
	115
	116	#endif /* DEBUG_H_12987983217 */