X-Git-Url: https://pd.if.org/git/?p=pdclib;a=blobdiff_plain;f=includes%2Fassert.h;h=44b30b87b7bdbe98281ad086afed1162fb623a4c;hp=7bd6e41a6ded9145224628d42479ec32ec0e2274;hb=0b6ba474c9a13ef218554539106c0a52776ac189;hpb=1d9d92ba957a0b8307c9a65c35867fde68e6533b diff --git a/includes/assert.h b/includes/assert.h index 7bd6e41..44b30b8 100644 --- a/includes/assert.h +++ b/includes/assert.h @@ -1,37 +1,70 @@ -/* ---------------------------------------------------------------------------- - * $Id$ - * ---------------------------------------------------------------------------- - * Public Domain C Library - http://pdclib.sourceforge.net - * This code is Public Domain. Use, modify, and redistribute at will. - * ---------------------------------------------------------------------------- - * Diagnostics - * --------------------------------------------------------------------------*/ - -#ifndef _ASSERT_H -#define _ASSERT_H _ASSERT_H - -/* ---------------------------------------------------------------------------- - * AUXILIARY - * --------------------------------------------------------------------------*/ - -/* Helper function doing the print to stderr and call to abort(). */ -void __assert( char const * const expression, /* the tested expression */ - char const * const file, /* name of source file */ - char const * const function, /* name of function */ - int const line ); /* number of source file line */ - -#endif /* _ASSERT_H - note that the header guard ends here on purpose. The - assert macro is redefined upon each inclusion, in - dependence of NDEBUG. */ - -/* ---------------------------------------------------------------------------- - * DEFINES - * --------------------------------------------------------------------------*/ +/* 7.2 Diagnostics + This file is part of the Public Domain C Library (PDCLib). + Permission is granted to use, modify, and / or redistribute at will. +*/ + +#include <_PDCLIB_aux.h> +#include <_PDCLIB_config.h> + +/* + Defines a macro assert() that, depending on the value of the preprocessor + symbol NDEBUG, does + * evaluate to a void expression if NDEBUG is set OR the parameter expression + evaluates to true; + * print an error message and terminates the program if NDEBUG is not set AND + the parameter expression evaluates to false. + The error message contains the parameter expression, name of the source file + (__FILE__), line number (__LINE__), and (from C99 onward) name of the function + (__func__). + The header can be included MULTIPLE times, and redefines the macro depending + on the current setting of NDEBUG. +*/ + +_PDCLIB_BEGIN_EXTERN_C + +#ifndef _PDCLIB_ASSERT_H +#define _PDCLIB_ASSERT_H _PDCLIB_ASSERT_H + +/* Functions _NOT_ tagged noreturn as this hampers debugging */ +void _PDCLIB_assert99( char const * const, char const * const, char const * const ); +void _PDCLIB_assert89( char const * const ); + +#if _PDCLIB_C_VERSION >= 2011 +#define static_assert _Static_assert +#else +#define static_assert( e, m ) +#endif + +#endif + +/* If NDEBUG is set, assert() is a null operation. */ #undef assert -#if defined NDEBUG -#define assert( x ) ( (void) 0 ) + +#ifdef NDEBUG +#define assert( ignore ) ( (void) 0 ) +#elif _PDCLIB_C_MIN(99) +#define assert(expression) \ + do { if(!(expression)) { \ + _PDCLIB_assert99("Assertion failed: " _PDCLIB_symbol2string(expression)\ + ", function ", __func__, \ + ", file " __FILE__ \ + ", line " _PDCLIB_symbol2string( __LINE__ ) \ + "." _PDCLIB_endl ); \ + _PDCLIB_UNREACHABLE; \ + } \ + } while(0) + #else -#define assert( x ) ( x ) ? ( (void) 0 ) \ - : __assert( #x, __FILE__, __func__, __LINE__ ) +#define assert(expression) \ + do { if(!(expression)) { \ + _PDCLIB_assert89("Assertion failed: " _PDCLIB_symbol2string(expression)\ + ", file " __FILE__ \ + ", line " _PDCLIB_symbol2string( __LINE__ ) \ + "." _PDCLIB_endl ); \ + _PDCLIB_UNREACHABLE; \ + } \ + } while(0) #endif + +_PDCLIB_END_EXTERN_C