IssueReporting.h 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. // Jolt Physics Library (https://github.com/jrouwe/JoltPhysics)
  2. // SPDX-FileCopyrightText: 2021 Jorrit Rouwe
  3. // SPDX-License-Identifier: MIT
  4. #pragma once
  5. JPH_NAMESPACE_BEGIN
  6. /// Trace function, needs to be overridden by application. This should output a line of text to the log / TTY.
  7. using TraceFunction = void (*)(const char *inFMT, ...);
  8. JPH_EXPORT extern TraceFunction Trace;
  9. // Always turn on asserts in Debug mode
  10. #if defined(_DEBUG) && !defined(JPH_ENABLE_ASSERTS)
  11. #define JPH_ENABLE_ASSERTS
  12. #endif
  13. #ifdef JPH_ENABLE_ASSERTS
  14. /// Function called when an assertion fails. This function should return true if a breakpoint needs to be triggered
  15. using AssertFailedFunction = bool(*)(const char *inExpression, const char *inMessage, const char *inFile, uint inLine);
  16. JPH_EXPORT extern AssertFailedFunction AssertFailed;
  17. // Helper functions to pass message on to failed function
  18. struct AssertLastParam { };
  19. inline bool AssertFailedParamHelper(const char *inExpression, const char *inFile, uint inLine, AssertLastParam) { return AssertFailed(inExpression, nullptr, inFile, inLine); }
  20. inline bool AssertFailedParamHelper(const char *inExpression, const char *inFile, uint inLine, const char *inMessage, AssertLastParam) { return AssertFailed(inExpression, inMessage, inFile, inLine); }
  21. /// Main assert macro, usage: JPH_ASSERT(condition, message) or JPH_ASSERT(condition)
  22. #define JPH_ASSERT(inExpression, ...) do { if (!(inExpression) && AssertFailedParamHelper(#inExpression, __FILE__, JPH::uint(__LINE__), ##__VA_ARGS__, JPH::AssertLastParam())) JPH_BREAKPOINT; } while (false)
  23. #define JPH_IF_ENABLE_ASSERTS(...) __VA_ARGS__
  24. #else
  25. #define JPH_ASSERT(...) ((void)0)
  26. #define JPH_IF_ENABLE_ASSERTS(...)
  27. #endif // JPH_ENABLE_ASSERTS
  28. JPH_NAMESPACE_END