std::breakp...f_debugging(3)

okay so bestie, welcome to the C++ Standard Libary manual — the header shows it as std::breakp...f_debugging(3) because truncation ate the rest 😭, but today's main character is std::breakpoint_if_debugging. let's get into it 💅

💖 NAME 💖

std::breakpoint_if_debugging — literally std::breakpoint_if_debugging, that's the name, periodt.

✨ Synopsis ✨

Defined in header <debugging>:

void breakpoint_if_debugging() noexcept;  (since C++26)

It's a conditional breakpoint: it attempts to temporarily halt the execution of the program and transfer control to the debugger if it were able to determine that the debugger is present. Otherwise? No-op city. Acts as a no-op otherwise 🫶

Formally, the behavior of this function is completely implementation-defined.

Equivalent to this exact vibe:

if (std::is_debugger_present())
    std::breakpoint();

🎀 Notes 🎀

Feature-test macro tea ☕:

• __cpp_lib_debugging = 202311L — Std: (C++26), Feature: Debugging support library
• __cpp_lib_debugging = 202403L — Std: (C++26), Feature: Replaceable std::is_debugger_present

🌸 Example 🌸

This section is incomplete 😭 Reason: no example

🦋 See also 🦋

• is_debugger_present — checks whether a program is running under the control of a debugger. (C++26) (function)
• breakpoint — pauses the running program when called. (C++26) (function)

🗂️ Category 🗂️

• Todo no example

mwah 💋 source is http://cppreference.com, date 2024.06.10, and the footer version/slug is std::breakp...f_debugging(3) — that's the whole page, bestie, go debug something cute 🌈👑