# std::breakpoint

> C++ Atlas: `cppatlas.com/w/cpp/utility/breakpoint` | Source: https://en.cppreference.com/w/cpp/utility/breakpoint | Domain: Utility | Standards: C++26

Unconditional breakpoint: Attempts to temporarily stop program execution and pass control to the debugger, regardless of whether the presence of a debugger can be detected.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <debugging>
void breakpoint() noexcept; // (since C++26)
```

Unconditional breakpoint: Attempts to temporarily stop program execution and pass control to the debugger, regardless of whether the presence of a debugger can be detected. The behavior of this function is implementation-defined.

### Notes

The intent of this function is allowing for runtime control of breakpoints beyond what might be available from a debugger while not causing the program to exit. For example, breaking when an infrequent non-critical condition is detected, allowing programmatic control with complex runtime sensitive conditions, breaking on user input to inspect context in interactive programs without needing to switch to the debugger application, etc.

This function standardizes many similar existing facilities: `__builtin_debugtrap` from LLVM, `__debugbreak` from Win32 API, `debugger_break` from boost.test, `assert(false)`, `_asm { int 3 }` (MSVC) and `asm("int3")` (GCC/clang) for x86 targets, etc.

| Feature-test macro | Value | Std | Feature |
| --- | --- | --- | --- |
| `__cpp_lib_debugging` | `202311L` | (C++26) | Debugging support library |
| `__cpp_lib_debugging` | `202403L` | (C++26) | Replaceable `std::is_debugger_present` |

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`is_debugger_present`](https://en.cppreference.com/w/cpp/utility/is_debugger_present) (C++26): checks whether a program is running under the control of a debugger (function)
- [`breakpoint_if_debugging`](https://en.cppreference.com/w/cpp/utility/breakpoint_if_debugging) (C++26): calls `std::breakpoint` if `std::is_debugger_present` returns `true` (function)

### External links

|   |   |
| --- | --- |
| 1. | armKEIL: `__breakpoint` intrinsic |
| 2. | Portable Snippets: Debugging assertions and traps |
| 3. | EASTL: `EASTL_DEBUG_BREAK` |
| 4. | Catch2: `CATCH_TRAP` and `CATCH_BREAK_INTO_DEBUGGER` |
| 5. | Unreal Engine: `DebugBreak` |
| 6. | JUCE: `JUCE_BREAK_IN_DEBUGGER` |
| 7. | Dear ImGui: `IM_DEBUG_BREAK` |
| 8. | AWS C Common: `aws_debug_break` |

---
Attribution: content from https://en.cppreference.com/w/cpp/utility/breakpoint (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.