SDL3pp_assert.h

#ifndef SDL3PP_ASSERT_H_
#define SDL3PP_ASSERT_H_
 
#include <SDL3/SDL_assert.h>
#include "SDL3pp_callbackWrapper.h"
#include "SDL3pp_strings.h"
 
namespace SDL {
 
#ifdef SDL3PP_DOC
 
#define SDL_ASSERT_LEVEL SomeNumberBasedOnVariousFactors
 
#define SDL_TriggerBreakpoint() TriggerABreakpointInAPlatformSpecificManner
 
#define SDL_FUNCTION __FUNCTION__
 
#define SDL_FILE __FILE_NAME__
 
#if SDL_VERSION_ATLEAST(3, 4, 0)
 
#define SDL_ASSERT_FILE SDL_FILE
 
#endif // SDL_VERSION_ATLEAST(3, 4, 0)
 
#define SDL_LINE __LINE__
 
#define SDL_NULL_WHILE_LOOP_CONDITION (0)
 
#define SDL_disabled_assert(condition)                                         \
  do {                                                                         \
    (void)sizeof((condition));                                                 \
  } while (SDL_NULL_WHILE_LOOP_CONDITION)
 
#endif // SDL3PP_DOC
 
using AssertState = SDL_AssertState;
 
constexpr AssertState ASSERTION_RETRY =
  SDL_ASSERTION_RETRY; 
 
constexpr AssertState ASSERTION_BREAK =
  SDL_ASSERTION_BREAK; 
 
constexpr AssertState ASSERTION_ABORT =
  SDL_ASSERTION_ABORT; 
 
constexpr AssertState ASSERTION_IGNORE =
  SDL_ASSERTION_IGNORE; 
 
constexpr AssertState ASSERTION_ALWAYS_IGNORE =
  SDL_ASSERTION_ALWAYS_IGNORE; 
 
using AssertData = SDL_AssertData;
 
inline AssertState ReportAssertion(AssertData* data,
                                   StringParam func,
                                   StringParam file,
                                   int line)
{
  return SDL_ReportAssertion(data, func, file, line);
}
 
#ifdef SDL3PP_DOC
 
#define SDL_AssertBreakpoint() SDL_TriggerBreakpoint()
 
#define SDL_enabled_assert(condition)                                          \
  do {                                                                         \
    while (!(condition)) {                                                     \
      static struct SDL_AssertData sdl_assert_data = {                         \
        false, 0, #condition, NULL, 0, NULL, NULL};                            \
      const SDL_AssertState sdl_assert_state = SDL_ReportAssertion(            \
        &sdl_assert_data, SDL_FUNCTION, SDL_ASSERT_FILE, SDL_LINE);            \
      if (sdl_assert_state == SDL_ASSERTION_RETRY) {                           \
        continue; /* go again. */                                              \
      } else if (sdl_assert_state == SDL_ASSERTION_BREAK) {                    \
        SDL_AssertBreakpoint();                                                \
      }                                                                        \
      break; /* not retrying. */                                               \
    }                                                                          \
  } while (SDL_NULL_WHILE_LOOP_CONDITION)
 
#define SDL_assert(condition)                                                  \
  if (assertion_enabled && (condition)) { trigger_assertion; }
 
#define SDL_assert_release(condition) SDL_disabled_assert(condition)
 
#define SDL_assert_paranoid(condition) SDL_disabled_assert(condition)
 
#define SDL_assert_always(condition) SDL_enabled_assert(condition)
 
#endif // SDL3PP_DOC
 
using AssertionHandler = AssertState(SDLCALL*)(const AssertData* data,
                                               void* userdata);
 
using AssertionHandlerCB =
  MakeTrailingCallback<AssertState(const AssertData* data)>;
 
inline void SetAssertionHandler(AssertionHandler handler, void* userdata)
{
  return SDL_SetAssertionHandler(handler, userdata);
}
 
inline void SetAssertionHandler(AssertionHandlerCB handler)
{
  SetAssertionHandler(handler.wrapper, handler.data);
}
 
inline AssertionHandler GetDefaultAssertionHandler()
{
  return SDL_GetDefaultAssertionHandler();
}
 
inline AssertionHandler GetAssertionHandler(void** puserdata)
{
  return SDL_GetAssertionHandler(puserdata);
}
inline const AssertData& GetAssertionReport()
{
  return *SDL_GetAssertionReport();
}
 
inline void ResetAssertionReport() { SDL_ResetAssertionReport(); }
 
 
} // namespace SDL
 
#endif /* SDL3PP_ASSERT_H_ */