mirror of
https://github.com/dborth/vbagx.git
synced 2024-12-27 03:01:50 +01:00
93 lines
3.3 KiB
C
93 lines
3.3 KiB
C
/* Included at the beginning of library source files, AFTER all other #include lines.
|
|
Sets up helpful macros and services used in my source code. Since this is only "active"
|
|
in my source code, I don't have to worry about polluting the global namespace with
|
|
unprefixed names. */
|
|
|
|
// Gb_Snd_Emu 0.2.0
|
|
#ifndef BLARGG_SOURCE_H
|
|
#define BLARGG_SOURCE_H
|
|
|
|
// The following four macros are for debugging only. Some or all might be defined
|
|
// to do nothing, depending on the circumstances. Described is what happens when
|
|
// a particular macro is defined to do something. When defined to do nothing, the
|
|
// macros do NOT evaluate their argument(s).
|
|
|
|
// If expr is false, prints file and line number, then aborts program. Meant for
|
|
// checking internal state and consistency. A failed assertion indicates a bug
|
|
// in MY code.
|
|
//
|
|
// void assert( bool expr );
|
|
#include <assert.h>
|
|
|
|
// If expr is false, prints file and line number, then aborts program. Meant for
|
|
// checking caller-supplied parameters and operations that are outside the control
|
|
// of the module. A failed requirement probably indicates a bug in YOUR code.
|
|
//
|
|
// void require( bool expr );
|
|
#undef require
|
|
#define require( expr ) assert( expr )
|
|
|
|
// Like printf() except output goes to debugging console/file.
|
|
//
|
|
// void dprintf( const char* format, ... );
|
|
static inline void blargg_dprintf_( const char*, ... ) { }
|
|
#undef dprintf
|
|
#define dprintf (1) ? (void) 0 : blargg_dprintf_
|
|
|
|
// If expr is false, prints file and line number to debug console/log, then
|
|
// continues execution normally. Meant for flagging potential problems or things
|
|
// that should be looked into, but that aren't serious problems.
|
|
//
|
|
// void check( bool expr );
|
|
#undef check
|
|
#define check( expr ) ((void) 0)
|
|
|
|
// If expr yields non-NULL error string, returns it from current function,
|
|
// otherwise continues normally.
|
|
#undef RETURN_ERR
|
|
#define RETURN_ERR( expr ) do { \
|
|
blargg_err_t blargg_return_err_ = (expr); \
|
|
if ( blargg_return_err_ ) return blargg_return_err_; \
|
|
} while ( 0 )
|
|
|
|
// If ptr is NULL, returns "Out of memory" error string, otherwise continues normally.
|
|
#undef CHECK_ALLOC
|
|
#define CHECK_ALLOC( ptr ) do { if ( (ptr) == 0 ) return "Out of memory"; } while ( 0 )
|
|
|
|
// The usual min/max functions for built-in types.
|
|
//
|
|
// template<typename T> T min( T x, T y ) { return x < y ? x : y; }
|
|
// template<typename T> T max( T x, T y ) { return x > y ? x : y; }
|
|
#define BLARGG_DEF_MIN_MAX( type ) \
|
|
static inline type blargg_min( type x, type y ) { if ( y < x ) x = y; return x; }\
|
|
static inline type blargg_max( type x, type y ) { if ( x < y ) x = y; return x; }
|
|
|
|
BLARGG_DEF_MIN_MAX( int )
|
|
BLARGG_DEF_MIN_MAX( unsigned )
|
|
BLARGG_DEF_MIN_MAX( long )
|
|
BLARGG_DEF_MIN_MAX( unsigned long )
|
|
BLARGG_DEF_MIN_MAX( float )
|
|
BLARGG_DEF_MIN_MAX( double )
|
|
|
|
#undef min
|
|
#define min blargg_min
|
|
|
|
#undef max
|
|
#define max blargg_max
|
|
|
|
// typedef unsigned char byte;
|
|
typedef unsigned char blargg_byte;
|
|
#undef byte
|
|
#define byte blargg_byte
|
|
|
|
// deprecated
|
|
#define BLARGG_CHECK_ALLOC CHECK_ALLOC
|
|
#define BLARGG_RETURN_ERR RETURN_ERR
|
|
|
|
// BLARGG_SOURCE_BEGIN: If defined, #included, allowing redefition of dprintf and check
|
|
#ifdef BLARGG_SOURCE_BEGIN
|
|
#include BLARGG_SOURCE_BEGIN
|
|
#endif
|
|
|
|
#endif
|