Difference between revisions of "cpp/utility/is debugger present"
(Applied P2810R4 (is_debugger_present is_replaceable).) |
m (~) |
||
| Line 1: | Line 1: | ||
{{cpp/title|is_debugger_present}} | {{cpp/title|is_debugger_present}} | ||
| − | {{cpp/ | + | {{cpp/error/navbar}} |
{{ddcl|header=debugging|since=c++26| | {{ddcl|header=debugging|since=c++26| | ||
bool is_debugger_present() noexcept; | bool is_debugger_present() noexcept; | ||
Latest revision as of 20:59, 30 October 2024
| Defined in header <debugging>
|
||
| bool is_debugger_present() noexcept; |
(since C++26) | |
Attempts to determine if the program is being executed with debugger present.
By default, the behavior of this function is completely implementation-defined. A C++ program may provide the definition of this signature to replace the behavior of this function.
Contents |
[edit] Return value
The default version returns true if, to the best of its knowledge, the program is executed under a debugger.
[edit] Notes
The intent of this function is allowing printing out extra output to help diagnose problems, executing extra test code, displaying an extra user interface to help in debugging, etc.
This function standardizes many similar existing facilities: under_debugger from boost.test, IsDebuggerPresent() from Win32 API, isDebuggerActive from Catch2, IsDebuggerPresent from Unreal Engine, etc.
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_debugging |
202311L | (C++26) | Debugging support library |
| 202403L | (C++26) | Replaceable std::is_debugger_present
|
[edit] Example
| This section is incomplete Reason: no example |
[edit] See also
| (C++26) |
pauses the running program when called (function) |
| (C++26) |
calls std::breakpoint if std::is_debugger_present returns true (function) |
