xtd_c - Reference Guide 0.2.0
debug

Definition

All needed for debugging and tracing.

Modules

 debug
 Provides a set of methods and properties that help you debug the execution of your code.
 
 debugger
 Enables communication with a debugger.
 
 trace_listener
 Provides the abstract base class for the listeners who monitor trace and debug output.
 

Macros

#define assert_(...)   if (__var_xtd_diagnostics_debug_should_aborted__((__assert_args__){csf_, __VA_ARGS__})) debug_break_()
 Checks for a condition; if the condition is false, displays a message box that shows the call stack. More...
 
#define cassert_(...)   assert_(__VA_ARGS__)
 Checks for a condition; if the condition is false, displays a message box that shows the call stack. More...
 
#define debug_break_()   if (xtd_diagnostics_debugger_launch()) abort()
 Signals a breakpoint to an attached debugger. More...
 

Macro Definition Documentation

◆ assert_

#define assert_ (   ...)    if (__var_xtd_diagnostics_debug_should_aborted__((__assert_args__){csf_, __VA_ARGS__})) debug_break_()

Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Parameters
conditionThe conditional expression to evaluate. If the condition is true, a failure message is not sent and the message box is not displayed.
message(optional) The message to send to the xtd_diagnostics_debug_listeners collection.
Examples
The following example shows how to use assert_ macro.
Library
xtdc.core
Examples
The following example shows how to use assert_ macro with message.

◆ cassert_

#define cassert_ (   ...)    assert_(__VA_ARGS__)

Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Parameters
conditionThe conditional expression to evaluate. If the condition is true, a failure message is not sent and the message box is not displayed.
message(optional) The message to send to the xtd_diagnostics_debug_listeners collection.
Library
xtdc.core
Examples
The following example shows how to use cassert_ macro.
Examples
The following example shows how to use cassert_ macro with message.

◆ debug_break_

#define debug_break_ ( )    if (xtd_diagnostics_debugger_launch()) abort()

Signals a breakpoint to an attached debugger.

Library
xtd.core
Examples
The following code example demonstrates how to stop the debugger at the call to xtd_console_write_line.