#include <format_exception.h>

Definition

The exception that is thrown when the format of an argument does not meet the parameter specifications of the invoked method.

Namespace: xtd

Library: xtd.core

Examples: The following example demonstrates how to throw and catch an format_exception.
#include <xtd/xtd>

using namespace std;

using namespace xtd;

int main() {

cout << ustring::format("{}", exception()) << endl;

cout << ustring::format("{}", invalid_argument("Invvalid argument")) << endl;

cout << ustring::format("{}", system_exception("System exception")) << endl;

cout << ustring::format("{}", argument_out_of_range_exception("Argument out of range exception")) << endl;

}

// This code produces the following output :

//

// exception: std::exception

// exception: Invvalid argument

// xtd::system_exception : System exception

// at main [0x00005620] in /Users/gammasoft71/Projects/xtd/build/xtd.examples/xtd.core.examples/format/format_exception/Debug/format_exception:line 0

// xtd::argument_out_of_range_exception : Argument out of range exception

// at main [0x00005620] in /Users/gammasoft71/Projects/xtd/build/xtd.examples/xtd.core.examples/format/format_exception/Debug/format_exception:line 0

xtd::argument_out_of_range_exception
The exception that is thrown when one of the arguments provided to a method is out of range.
Definition argument_out_of_range_exception.h:18

xtd::system_exception
Defines the base class for predefined exceptions in the xtd namespace.
Definition system_exception.h:24

xtd::ustring::format
static ustring format(const ustring &fmt, args_t &&... args)
Writes the text representation of the specified arguments list, to string using the specified format ...
Definition ustring.h:689

xtd
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition system_report.h:17

Inherits xtd::system_exception.

Inherited by xtd::io::file_format_exception, xtd::net::cookie_exception, xtd::net::protocol_violation_exception, and xtd::net::web_exception.

Public Member Functions
	format_exception (const std::exception &inner_exception, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::ustring &message, const std::error_code &error, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::ustring &message, const std::error_code &error, const xtd::ustring &help_link, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::ustring &message, const std::exception &inner_exception, const std::error_code &error, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::ustring &message, const std::exception &inner_exception, const std::error_code &error, const xtd::ustring &help_link, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::ustring &message, const std::exception &inner_exception, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::ustring &message, const std::exception &inner_exception, const xtd::ustring &help_link, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::ustring &message, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

	format_exception (const xtd::ustring &message, const xtd::ustring &help_link, const xtd::diagnostics::stack_frame &info=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class format_exception.

Public Member Functions inherited from xtd::system_exception
	system_exception (const std::exception &inner_exception, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::ustring &message, const std::error_code &error, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::ustring &message, const std::error_code &error, const xtd::ustring &help_link, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::ustring &message, const std::exception &inner_exception, const std::error_code &error, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::ustring &message, const std::exception &inner_exception, const std::error_code &error, const xtd::ustring &help_link, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::ustring &message, const std::exception &inner_exception, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::ustring &message, const std::exception &inner_exception, const xtd::ustring &help_link, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::ustring &message, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

	system_exception (const xtd::ustring &message, const xtd::ustring &help_link, const xtd::diagnostics::stack_frame &information=xtd::diagnostics::stack_frame::empty())
	Create a new instance of class system_exception.

virtual std::error_code	error_code () const noexcept
	Get error associate to the exception.

virtual const xtd::ustring &	file_path () const noexcept
	Get file path where exception occurred.

virtual const xtd::ustring &	help_link () const noexcept
	Gets a link to the help file associated with this exception.

virtual exception_ref	inner_exception () const noexcept
	Gets the exception instance that caused the current exception.

virtual uint32_t	line_number () const noexcept
	Get Line number where the exception occurred.

virtual const xtd::ustring &	member_name () const noexcept
	Get file member where exception occurred.

virtual const xtd::ustring &	message () const noexcept
	Get message associate to the exception.

virtual const xtd::ustring &	name () const noexcept
	Get full class name the exception.

virtual xtd::ustring	stack_trace () const noexcept
	Gets a string representation of the immediate frames on the call stack.

xtd::ustring	to_string () const noexcept override
	Returns a string that represents the current exception.

const char *	what () const noexcept override
	Get message associate to the exception.

Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object.

virtual bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object.

virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type.

template<typename object_t >
std::unique_ptr< object_t >	memberwise_clone () const
	Gets the type of the current instance.

virtual xtd::ustring	to_string () const noexcept
	Returns a std::string that represents the current object.

Additional Inherited Members
Public Types inherited from xtd::system_exception
using	exception_ref = std::optional< std::reference_wrapper< const std::exception > >
	Optional reference wrapper on std::exception.

Static Public Member Functions inherited from xtd::system_exception
static bool	enable_stack_trace ()
	Gets or sets if the generation of the stack trace is enabled.

static void	enable_stack_trace (bool enable)

Static Public Member Functions inherited from xtd::object
static bool	equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are considered equal.

static bool	reference_equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are the same instance.

Constructor & Destructor Documentation

◆ format_exception() [1/10]

xtd::format_exception::format_exception ( const xtd::diagnostics::stack_frame & info = xtd::diagnostics::stack_frame::empty() )

inline

Create a new instance of class format_exception.

Parameters

information (optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

Remarks: Message is set with the default message associate to the exception.

◆ format_exception() [2/10]

xtd::format_exception::format_exception	(	const xtd::ustring &	message,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inlineexplicit

Create a new instance of class format_exception.

Parameters

message	Message string associate to the exception.
information	(optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

◆ format_exception() [3/10]

xtd::format_exception::format_exception	(	const xtd::ustring &	message,
		const std::error_code &	error,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inlineexplicit

Create a new instance of class format_exception.

Parameters

message	Message string associate to the exception.
error	Error code associate to the exception.
information	(optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

◆ format_exception() [4/10]

xtd::format_exception::format_exception	(	const xtd::ustring &	message,
		const xtd::ustring &	help_link,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inlineexplicit

Create a new instance of class format_exception.

Parameters

message	Message string associate to the exception.
help_link	Help link string associate to the exception.
information	(optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

◆ format_exception() [5/10]

xtd::format_exception::format_exception	(	const xtd::ustring &	message,
		const std::error_code &	error,
		const xtd::ustring &	help_link,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inlineexplicit

Create a new instance of class format_exception.

Parameters

message	Message string associate to the exception.
error	Error code associate to the exception.
help_link	Help link string associate to the exception.

◆ format_exception() [6/10]

xtd::format_exception::format_exception	(	const std::exception &	inner_exception,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inline

Create a new instance of class format_exception.

Parameters

inner_exception	The exception that is the cause of the current exception.
information	(optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

Remarks: Message is set with the default message associate to the exception.

◆ format_exception() [7/10]

xtd::format_exception::format_exception	(	const xtd::ustring &	message,
		const std::exception &	inner_exception,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inlineexplicit

Create a new instance of class format_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
information	(optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

◆ format_exception() [8/10]

xtd::format_exception::format_exception	(	const xtd::ustring &	message,
		const std::exception &	inner_exception,
		const std::error_code &	error,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inlineexplicit

Create a new instance of class format_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
error	Error code associate to the exception.
information	(optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

◆ format_exception() [9/10]

xtd::format_exception::format_exception	(	const xtd::ustring &	message,
		const std::exception &	inner_exception,
		const xtd::ustring &	help_link,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inlineexplicit

Create a new instance of class format_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
help_link	Help link string associate to the exception.
information	(optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

◆ format_exception() [10/10]

xtd::format_exception::format_exception	(	const xtd::ustring &	message,
		const std::exception &	inner_exception,
		const std::error_code &	error,
		const xtd::ustring &	help_link,
		const xtd::diagnostics::stack_frame &	info = `xtd::diagnostics::stack_frame::empty()`
	)

inlineexplicit

Create a new instance of class format_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
error	Error code associate to the exception.
help_link	Help link string associate to the exception.
information	(optional) Contains current information about member name, file path and line number in the file where the exception is occurred. Typically current_stack_frame_.

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

xtd.core/include/xtd/format_exception.h

Definition

Public Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

◆ format_exception() [1/10]

◆ format_exception() [2/10]

◆ format_exception() [3/10]

◆ format_exception() [4/10]

◆ format_exception() [5/10]

◆ format_exception() [6/10]

◆ format_exception() [7/10]

◆ format_exception() [8/10]

◆ format_exception() [9/10]

◆ format_exception() [10/10]