std:: is_debugger_present
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.
Return value
The default version returns true if, to the best of its knowledge, the program is executed under a debugger.
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
|
Example
This section is incomplete
Reason: no example |
See also
(C++26)
|
pauses the running program when called
(function) |
(C++26)
|
calls
std::breakpoint
if
std::is_debugger_present
returns
true
(function) |