breakpoint.hpp

浏览该文件的文档.

#ifndef NEFORCE_CORE_EXCEPTION_BREAKPOINT_HPP__
#define NEFORCE_CORE_EXCEPTION_BREAKPOINT_HPP__

 
#include "NeForce/core/config/c++config.hpp"
NEFORCE_BEGIN_NAMESPACE__

 
#if defined(NEFORCE_STATE_DEBUG) || defined(NEXUSFORCE_ENABLE_DOXYGEN)
#    define NEFORCE_DEBUG_VERIFY(CON, MESG) \
        {                                   \
            if (CON) {                      \
            } else {                        \
                assert(false && MESG);      \
            }                               \
        }
#else
#    define NEFORCE_DEBUG_VERIFY(CON, MESG)
#endif
 
#if defined(NEFORCE_STANDARD_20) || defined(NEXUSFORCE_ENABLE_DOXYGEN)
#    define NEFORCE_CONSTEXPR_ASSERT(COND)                         \
        do {                                                       \
            if (_NEFORCE is_constant_evaluated() && !bool(COND)) { \
                _NEFORCE unreachable();                            \
            }                                                      \
        } while (false);
#else
#    define NEFORCE_CONSTEXPR_ASSERT(COND)
#endif
 

NEFORCE_NORETURN NEFORCE_ALWAYS_INLINE_INLINE void unreachable() noexcept {
#ifdef NEFORCE_COMPILER_GNUC
    __builtin_unreachable();
#else
    __assume(false);
#endif
}
 
#if defined(NEFORCE_STANDARD_17) || defined(NEXUSFORCE_ENABLE_DOXYGEN)
NEFORCE_NODISCARD NEFORCE_ALWAYS_INLINE_INLINE constexpr bool is_constant_evaluated() noexcept {
    return __builtin_is_constant_evaluated();
}
#endif

bool NEFORCE_API is_debugger_present();

void NEFORCE_API debug_assert(bool condition, const char* message = nullptr);

NEFORCE_ALWAYS_INLINE_INLINE void breakpoint() noexcept {
#ifdef NEFORCE_PLATFORM_WINDOWS
    __debugbreak();
#else
#    ifdef NEFORCE_COMPILER_CLANG
    __builtin_debugtrap();
#    elif defined(NEFORCE_ARCH_X86)
    asm volatile("int3");
#    elif defined(NEFORCE_ARCH_AARCH64)
    asm volatile(".inst 0xd4200000");
#    elif defined(NEFORCE_ARCH_ARM32)
    asm volatile(".inst 0xe7f001f0");
#    elif defined(NEFORCE_ARCH_RISCV)
    asm volatile("ebreak");
#    elif defined(NEFORCE_ARCH_LOONGARCH)
    asm volatile("break 0");
#    else
    __builtin_trap();
#    endif
#endif
}

NEFORCE_ALWAYS_INLINE_INLINE void breakpoint_if_debugging() {
    if (is_debugger_present()) {
        breakpoint();
    }
}
 // DebugBreakpointsAndAssertions
 
NEFORCE_END_NAMESPACE__
#endif // NEFORCE_CORE_EXCEPTION_BREAKPOINT_HPP__