Assert.h

// WARNING: Changes to this file must be contributed back to Sawyer or else they will
//          be clobbered by the next update from Sawyer.  The Sawyer repository is at
//          https://github.com/matzke1/sawyer.
 
 
 
 
#ifndef Sawyer_Assert_H
#define Sawyer_Assert_H
 
#include <Sawyer/Sawyer.h>
#include <string>
 
// If SAWYER_NDEBUG is defined then some of the macros defined in this header become no-ops.  For interoperability with the
// more standard NDEBUG symbol, we define SAWYER_NDEBUG if NDEBUG is defined.
#ifdef NDEBUG
#undef SAWYER_NDEBUG
#define SAWYER_NDEBUG
#endif
 
namespace Sawyer {                                      // documented elsewhere
 
namespace Assert {
 
SAWYER_EXPORT
#if __cplusplus >= 201103L
[[noreturn]]
#endif
void fail(const char *mesg, const char *expr, const std::string &note,
          const char *filename, unsigned linenum, const char *funcname);
 
typedef void (*AssertFailureHandler)(const char *mesg, const char *expr, const std::string &note,
                                     const char *filename, unsigned linenum, const char *funcname);
 
SAWYER_EXPORT extern AssertFailureHandler assertFailureHandler;
 
} // namespace
} // namespace
 
// These "always" macros are enabled regardless of whether SAWYER_NDEBUG is defined.  Don't use them for
// expensive assertions.
 
#define ASSERT_always_require(expr) ASSERT_always_require2(expr, "")
#define ASSERT_always_require2(expr, note)                                                                                     \
    ((expr) ?                                                                                                                  \
        static_cast<void>(0) :                                                                                                 \
        Sawyer::Assert::fail("assertion failed", "required: " #expr, (note),                                                   \
                             __FILE__, __LINE__, SAWYER_PRETTY_FUNCTION))
 
#define ASSERT_always_forbid(expr) ASSERT_always_forbid2(expr, "")
#define ASSERT_always_forbid2(expr, note)                                                                                      \
    (!(expr) ?                                                                                                                 \
        static_cast<void>(0) :                                                                                                 \
        Sawyer::Assert::fail("assertion failed",                                                                               \
                             "forbidden: " #expr, (note), __FILE__, __LINE__, SAWYER_PRETTY_FUNCTION))
 
#define ASSERT_always_not_null(expr) ASSERT_always_not_null2(expr, "")
#define ASSERT_always_not_null2(expr, note)                                                                                    \
    ((expr)!=NULL ?                                                                                                            \
        static_cast<void>(0) :                                                                                                 \
        Sawyer::Assert::fail("null pointer",                                                                                   \
                             #expr, (note), __FILE__, __LINE__, SAWYER_PRETTY_FUNCTION))
 
#define ASSERT_always_not_reachable(note)                                                                                      \
    Sawyer::Assert::fail("reached impossible state", NULL, (note),                                                             \
                         __FILE__, __LINE__, SAWYER_PRETTY_FUNCTION);
 
#define ASSERT_always_not_implemented(note)                                                                                    \
    Sawyer::Assert::fail("not implemented yet", NULL, (note),                                                                  \
                         __FILE__, __LINE__, SAWYER_PRETTY_FUNCTION)
 
#define ASSERT_always_this() /*void*/
 
// The non-"always" macros might change behavior based on whether SAWYER_NDEBUG is defined.
 
#ifdef SAWYER_NDEBUG
 
#define ASSERT_require(expr)            /*void*/
#define ASSERT_require2(expr, note)     /*void*/
#define ASSERT_forbid(expr)             /*void*/
#define ASSERT_forbid2(expr, note)      /*void*/
#define ASSERT_not_null(expr)           /*void*/
#define ASSERT_not_null2(expr, note)    /*void*/
#define ASSERT_not_reachable(note)      ASSERT_always_not_reachable(note)
#define ASSERT_not_implemented(note)    ASSERT_always_not_implemented(note)
#define ASSERT_this()                   /*void*/
 
#else
 
#define ASSERT_require(expr)            ASSERT_always_require(expr)
#define ASSERT_require2(expr, note)     ASSERT_always_require2(expr, note)
#define ASSERT_forbid(expr)             ASSERT_always_forbid(expr)
#define ASSERT_forbid2(expr, note)      ASSERT_always_forbid2(expr, note)
#define ASSERT_not_null(expr)           ASSERT_always_not_null(expr)
#define ASSERT_not_null2(expr, note)    ASSERT_always_not_null2(expr, note)
#define ASSERT_not_reachable(note)      ASSERT_always_not_reachable(note)
#define ASSERT_not_implemented(note)    ASSERT_always_not_implemented(note)
#define ASSERT_this()                   /*void*/
 
#endif
 
// Macros recognized by some IDEs
 
#define TODO(note)                                                                                                             \
    Sawyer::Assert::fail("not implemented yet", NULL, (note),                                                                  \
                         __FILE__, __LINE__, SAWYER_PRETTY_FUNCTION)
 
#define FIXME(note)                                                                                                            \
    Sawyer::Assert::fail("needs to be fixed", NULL, (note),                                                                    \
                         __FILE__, __LINE__, SAWYER_PRETTY_FUNCTION)
 
#endif