platform/base layer

include/platform/base/ci2_debug_trap.h

@@ -0,0 +1,42 @@
+/* - | Copyright | ------------------------------------------------------------
+   Copyright (c) 2026 Randy Jordan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+ * --------------------------------------------------------------------------*/
+#ifndef CI2_DEBUG_TRAP_H
+#define CI2_DEBUG_TRAP_H
+
+/* Use __has_builtin if available (Clang and newer GCC). */
+#if defined(__has_builtin)
+  /* Check builtins in preferred order */
+  #if __has_builtin(__builtin_debugtrap)
+    #define CI2_DEBUG_TRAP() __builtin_debugtrap()
+  #elif __has_builtin(__builtin_trap)
+    #define CI2_DEBUG_TRAP() __builtin_trap()
+  #elif __has_builtin(__builtin_break)
+    #define CI2_DEBUG_TRAP() __builtin_break()
+  #endif
+#elif defined(_MSC_VER) || defined(__INTEL__LLVM_COMPILER)
+  #define CI2_DEBUG_TRAP() __debugbreak()
+#else
+  #define CI2_DEBUG_TRAP() (*(volatile int*)0 = 0)
+#endif
+
+#endif // ci2_debug_trap.h