SDL_TriggerBreakpoint - Attempt to tell an attached debugger to pause.
Contents
Availability
This macro is available since SDL 3.2.0.
Simple Directmedia Layer SDL 3.2.10 SDL_TriggerBreakpoint(3)
Description
This allows an app to programmatically halt ("break") the debugger as if it had hit a breakpoint,
allowing the developer to examine program state, etc.
This is a macro--not a function--so that the debugger breaks on the source code line that used
SDL_TriggerBreakpoint
and not in some random guts of SDL. SDL_assert
uses this macro for the same reason.
If the program is not running under a debugger,
SDL_TriggerBreakpoint
will likely terminate the app, possibly without warning. If the current platform isn't supported, this
macro is left undefined.
Header File
Defined in SDL3/SDL_assert.h
Name
SDL_TriggerBreakpoint - Attempt to tell an attached debugger to pause.
Synopsis
#include"SDL3/SDL.h"#defineSDL_TriggerBreakpoint()TriggerABreakpointInAPlatformSpecificManner
Thread Safety
It is safe to call this macro from any thread.
