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_NORETURN void fail(const char *mesg, const char *expr, const std::string &note,
                                 const char *filename, unsigned linenum, const char *funcname) SAWYER_ATTR_NORETURN;

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()                                                                                                   \
    (this ?                                                                                                                    \
        static_cast<void>(0) :                                                                                                 \
        Sawyer::Assert::fail("assertion failed",                                                                               \
                             "required: this!=NULL", "'this' cannot be null in an object method",                              \
                             __FILE__, __LINE__, SAWYER_PRETTY_FUNCTION))

// 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()                   ASSERT_always_this()

#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