xtd::diagnostics::boolean_switch Class Reference

Inheritance diagram for xtd::diagnostics::boolean_switch:

Definition

Provides a simple on/off switch that controls debugging and tracing output.

class core_export_ boolean_switch : public xtd::diagnostics::switch_object

Inheritance

xtd::object → xtd::diagnostics::switch_object → xtd::diagnostics::boolean_switch

Header

#include <xtd/diagnostics/boolean_switch>

Namespace

xtd::diagnostics

Library

xtd.core

Remarks

You can use a boolean trace switch to enable or disable messages based on their importance. Use the xtd::diagnostics::boolean_switch::enabled property to get the current value of the switch.

You can create a xtd::diagnostics::boolean_switch in your code and set the xtd::diagnostics::boolean_switch::enabled property directly to instrument a specific section of code.

Examples

This example configuration section defines a xtd::diagnostics::boolean_switch with the xtd::diagnostics::boolean_switch::display_name property set to my_switch and the xtd::diagnostics::boolean_switch::enabled value set to true. Within your application, you can use the configured switch value by creating a xtd::diagnostics::boolean_switch with the same name, as shown in the following code example.

private:
  inline static xtd::diagnostics::boolean_switch boolean_switch("my_switch", "This is my switch");
 
public:
  static auto main() {
    //...
    console.write_line("Boolean switch {0} configured as {1}", boolean_switch.display_name(), boolean_switch.enabled());
    if (boolean_switch.enabled()) {
      //...
    }
  }

Remarks

To disable debug mode with CMake, add the command line add_definitions(-DNDEBUG) in your CMakeLists.txt, or define NDEBUG at the top of your file.

Note

If you define #define DEBUG above your includes, debug mode will still be active even if NDEBUG is defined.

Remarks

To activate your code if DEBUG is defined, you must enclose calls to the methods of Debug in an #if DEBUG ... #endif block.

To disable trace mode with CMake, add the command line add_definitions(-DNTRACE) in your CMakeLists.txt, or define NTRACE at the top of your file.

Note

If you define #define TRACE above your includes, trace mode will still be active even if NTRACE is defined.

Remarks

To activate your code if TRACE is defined, you must enclose calls to the methods of Debug in an #if TRACE ... #endif block.

For more information on instrumenting your application, see xtd::diagnostics::debug and xtd::diagnostics::trace.

Note

To improve performance, you can make xtd::diagnostics::boolean_switch members static in your class.

Public Constructors
	boolean_switch (const xtd::string &display_name, const xtd::string &description)
	Initializes a new instance of the xtd::diagnostics::boolean_switch class with the specified display name and description.
	boolean_switch (const xtd::string &display_name, const xtd::string &description, const xtd::string &default_switch_value)
	Initializes a new instance of the xtd::diagnostics::boolean_switch class with the specified display name, description, and default switch value.

Public Properties
auto	enabled () const -> bool
	Gets a value indicating whether the switch is enabled or disabled.
auto	enabled (bool enabled) -> void
	Sets a value indicating whether the switch is enabled or disabled.

Protected Methods
auto	on_value_changed () -> void override
	Determines whether the new value of the Value property can be parsed as a Boolean value.

Additional Inherited Members
using	attribute_collection
	Represents the attributes collection.
auto	attributes () const noexcept -> const attribute_collection &
	Gets the custom switch attributes.
auto	attributes () noexcept -> attribute_collection &
	Gets the custom switch attributes.
auto	attributes (const attribute_collection &attributes) noexcept -> void
	Sets the custom switch attributes.
auto	description () const noexcept -> const xtd::string &
	Gets a description of the switch.
auto	display_name () const noexcept -> const xtd::string &
	Gets a name used to identify the switch.
auto	value () const noexcept -> const xtd::string &
	Gets the value of the switch.
auto	value (const xtd::string &value) -> void
	Sets the value of the switch.
auto	equals (const xtd::object &obj) const noexcept -> bool override
	Determines whether the specified object is equal to the current object.
auto	equals (const switch_object &other) const noexcept -> bool override
	Determines whether the specified object is equal to the current object.
	object ()=default
	Create a new instance of the ultimate base class object.
virtual xtd::size	get_hash_code () const noexcept
	Serves as a hash function for a particular type.
virtual type_object	get_type () const noexcept
	Gets the type of the current instance.
template<class object_t>
xtd::unique_ptr_object< object_t >	memberwise_clone () const
	Creates a shallow copy of the current object.
virtual xtd::string	to_string () const
	Returns a xtd::string that represents the current object.
template<class object_a_t, class object_b_t>
static bool	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are considered equal.
template<class object_a_t, class object_b_t>
static bool	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are the same instance.
	switch_object (const xtd::string &display_name, const xtd::string &description)
	Initializes a new instance of the switch_object class.
auto	switch_setting () const noexcept -> xtd::int32
	Gets the current setting for this switch.
auto	switch_setting (xtd::int32 switch_setting) -> void
	Sets the current setting for this switch.
virtual auto	get_supported_attributes () const noexcept -> xtd::array< xtd::string >
	Gets the custom attributes supported by the switch.
virtual auto	on_switch_setting_changed () -> void
	Invoked when the switch_setting property is changed.

Constructor & Destructor Documentation

boolean_switch() [1/2]

xtd::diagnostics::boolean_switch::boolean_switch	(	const xtd::string &	display_name,
		const xtd::string &	description )

Initializes a new instance of the xtd::diagnostics::boolean_switch class with the specified display name and description.

Parameters

display_name	The name to display on a user interface.
description	The description of the switch.

Examples

The following example creates a xtd::diagnostics::boolean_switch and uses the switch to determine whether to print an error message. The switch is created at the class level. The Main method passes its location to MyMethod, which prints an error message and where the error occurred.

/* Class level declaration.*/
private:
  // Create a BooleanSwitch for data.
  inline static xtd::diagnostics::boolean_switch data_switch("data", "data_access module");
 
public:
  static void my_method(const xtd::string& location) {
    // Insert code here to handle processing.
    if (data_switch.enabled())
      console::write_line("Error happened at {}", location);
  }
 
  static auto main() {
    //Run the method which writes an error message specifying the location of the error.
    my_method("in Main");
  }

Remarks

When you create a xtd::diagnostics::boolean_switch, the display_name parameter is used to find initial switch settings. If the constructor cannot find initial settings, the xtd::diagnostics::boolean_switch::enabled property is set to false (disabled).

The switches you created should be static.

boolean_switch() [2/2]

xtd::diagnostics::boolean_switch::boolean_switch	(	const xtd::string &	display_name,
		const xtd::string &	description,
		const xtd::string &	default_switch_value )

Initializes a new instance of the xtd::diagnostics::boolean_switch class with the specified display name, description, and default switch value.

Parameters

display_name	The name to display on a user interface.
description	The description of the switch.
default_switch_value	The default value of the switch.

Remarks

The display_name parameter is used to set the value of the xtd::diagnostics::boolean_switch::display_name property, and the description parameter is use to set the value of the xtd::diagnostics::boolean_switch::description property. The default_switch_value parameter is saved as a field and used to initialize the xtd::diagnostics::boolean_switch::value property on first reference. For more information about constructor use, see the xtd::diagnostics::boolean_switch::booleanswitch(std::string, xtd::string) constructor.

Member Function Documentation

enabled() [1/2]

auto xtd::diagnostics::boolean_switch::enabled ( ) const -> bool

nodiscard

Gets a value indicating whether the switch is enabled or disabled.

Returns

true if the switch is enabled; otherwise, false. The default is false.

Remarks

By default, this field is set to false (disabled). To enable the switch, assign this field the value of true. To disable the switch, assign the value to false. The value of this property is determined by the value of the base class property xtd::diagnostics::boolean_switch::switch_setting.

enabled() [2/2]

auto xtd::diagnostics::boolean_switch::enabled

(

bool

enabled

)

-> void

Sets a value indicating whether the switch is enabled or disabled.

Parameters

enabled

true if the switch is enabled; otherwise, false. The default is false.

Remarks

By default, this field is set to false (disabled). To enable the switch, assign this field the value of true. To disable the switch, assign the value to false. The value of this property is determined by the value of the base class property xtd::diagnostics::boolean_switch::switch_setting.

on_value_changed()

auto xtd::diagnostics::boolean_switch::on_value_changed ( ) -> void

overrideprotectedvirtual

Determines whether the new value of the Value property can be parsed as a Boolean value.

Remarks

The xtd::diagnostics::boolean_switch::on_value_changed method determines whether the new value is a valid string representation of a boolean value ("false" or "true"). If so, the method sets the xtd::diagnostics::boolean_switch::switch_setting property to 0 or 1. Otherwise, the base method is called, which converts the string value to an integer value, which is then used to set the xtd::diagnostics::boolean_switch::switch_setting property.

Reimplemented from xtd::diagnostics::switch_object.

---

The documentation for this class was generated from the following file:

• xtd.core/include/xtd/diagnostics/boolean_switch.hpp