debug

Definition

All needed for debugging and tracing.

Classes
class	xtd::diagnostics::console_trace_listener
	Directs tracing or debugging output to either the standard output or the standard error stream. More...
class	xtd::diagnostics::debug
	Provides a set of methods and properties that help you debug the execution of your code. This class cannot be inherited. More...
class	xtd::diagnostics::debugger
	Enables communication with a debugger. This class cannot be inherited. More...
class	xtd::diagnostics::default_trace_listener
	Provides the default output methods and behavior for tracing. More...
class	xtd::diagnostics::ostream_trace_listener
	Directs tracing or debugging output to a std::ostream, such as std::fstream, std::stream... More...
class	xtd::diagnostics::source_location
	The xtd::diagnostics::source_location class represents certain information about the source code, such as file names, line numbers, and function names. Previously, functions that desire to obtain this information about the call site (for logging, testing, or debugging purposes) must use macros so that predefined macros like __LINE__ and __FILE__ are expanded in the context of the caller. The xtd::diagnostics::source_location class provides a better alternative. More...
class	xtd::diagnostics::stack_frame
	Provides information about a xtd::diagnostics::stack_frame, which represents a function call on the call stack for the current thread. More...
class	xtd::diagnostics::stack_trace
	Represents a stack trace, which is an ordered collection of one or more stack frames. More...
class	xtd::diagnostics::trace
	Provides a set of methods and properties that help you debug the execution of your code. This class cannot be inherited. More...
class	xtd::forms::control_trace_listener
	Directs tracing or debugging output to a icontrol_trace object. More...
class	xtd::forms::debug_form
	Represents a form that displays debug form. This class cannot be inherited. More...
class	xtd::forms::debug_message_box
	Displays a dialog box and write debug. More...
class	xtd::forms::debug_message_dialog
	Displays a message window and write debug, which presents a debug message to the user. More...
class	xtd::forms::enable_debug
	Represent enable debug class. More...
class	xtd::forms::trace_form
	Represents a form that displays trace form. This class cannot be inherited. More...
class	xtd::forms::trace_form_base
	Represents a base form for debug_form and trace_form forms. This class cannot be instantiated. More...
class	xtd::forms::trace_message_box
	Displays a dialog box and write trace. More...
class	xtd::forms::trace_message_dialog
	Displays a message window and write debug, which presents a debug message to the user. More...

Variables
auto	xtd::cdebugstreambuf
	A xtd::debugstreambuf variable used by xtd::cdebug ostream.
auto	xtd::ctracestreambuf
	A xtd::tracestreambuf variable used by xtd::ctrace ostream.

Public Static Methods
static auto	xtd::environment::unreachable () -> void
	The function unreachable expands to a void expression. Executing unreachable() results in undefined behavior.

Function Documentation

unreachable()

auto xtd::environment::unreachable ( ) -> void

inlinestatic

#include <environment.hpp>

The function unreachable expands to a void expression. Executing unreachable() results in undefined behavior.

Remarks

An implementation may use this to optimize impossible code branches away (typically, in optimized builds) or to trap them to prevent further execution (typically, in debug builds).

Header

#include <xtd/diagnostics/unreachable>

Library

xtd.core

Examples

The following code example demonstrates how to stop the debugger at the call to write_line.

 switch (value) {
  case 128: [[fallthrough]];
  case 256: [[fallthrough]];
  case 512: return  "good";
  default:  xtd::environment::unreachable();
}

Variable Documentation

cdebugstreambuf

std::ostream cdebug & xtd::cdebugstreambuf

inline

#include <cdebug.hpp>

A xtd::debugstreambuf variable used by xtd::cdebug ostream.

Provides an std::ostream for xtd::diagnostics::debug.

Header

#include <xtd/cdebug>

Namespace

xtd

Library

xtd.core

ctracestreambuf

std::ostream ctrace & xtd::ctracestreambuf

inline

#include <ctrace.hpp>

A xtd::tracestreambuf variable used by xtd::ctrace ostream.

Provides an std::ostream for xtd::diagnostics::trace.

Header

#include <xtd/ctrace>

Namespace

xtd

Library

xtd.core