dx::exception Class Reference

a throw's whole diagnostic: the OS result, where it was raised (frame, file, line), the thread and the moment, a formatted comment and the exception it grew out of. Each frame on the way out wraps the one below into a new exception of its own - dx_catchall and friends do nothing else - so previous is the chain down to the origin, deep copied and owned by the wrapper; dx::trace::unfold prints it. The constructor overloads below are one signature per combination of the optional leading arguments (previous, function, error, what) ahead of the mandatory frame/file/line, with and without the printf-style comment. More...

#include <dx_exception.h>

Inheritance diagram for dx::exception:

Collaboration diagram for dx::exception:

Public Member Functions
	exception ()
	exception (const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const char *function, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const char *function, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const char *function, const std::string &what, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const char *function, const std::string &what, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const char *function, os_result error, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const char *function, os_result error, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const char *function, os_result error, const std::string &what, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const char *function, os_result error, const std::string &what, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const exception &copy) noexcept
	exception (const exception *previous, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const exception *previous, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const exception *previous, const char *function, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const exception *previous, const char *function, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const exception *previous, const char *function, const std::string &what, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const exception *previous, const char *function, const std::string &what, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const exception *previous, const char *function, os_result error, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const exception *previous, const char *function, os_result error, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
template<typename ... arg_t>
	exception (const exception *previous, const char *function, os_result error, const std::string &what, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	chained complete constructor with variadic comment
	exception (const exception *previous, const char *function, os_result error, const std::string &what, const char *frame, const char *file, unsigned int line, const std::string &comment="")
	complete base constructor without variadic comment
	exception (const exception *previous, const std::string &what, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const exception *previous, const std::string &what, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const exception *previous, os_result error, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const exception *previous, os_result error, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const exception *previous, os_result error, const std::string &what, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const exception *previous, os_result error, const std::string &what, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (const std::string &what, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (const std::string &what, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (os_result error, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (os_result error, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
	exception (os_result error, const std::string &what, const char *frame, const char *file, unsigned int line) noexcept
template<typename ... arg_t>
	exception (os_result error, const std::string &what, const char *frame, const char *file, unsigned int line, arg_t... args) noexcept
exception &	operator= (const exception &copy) noexcept
virtual	~exception ()

Public Attributes
std::string	comment
os_result	error {}
const char *	file {}
const char *	frame {}
const char *	function {}
unsigned int	line {}
bool	owner {}
const exception *	previous {}
std::string	thread {thread::name()}
std::time_t	time {std::chrono::system_clock::to_time_t (std::chrono::system_clock::now())}

Detailed Description

a throw's whole diagnostic: the OS result, where it was raised (frame, file, line), the thread and the moment, a formatted comment and the exception it grew out of. Each frame on the way out wraps the one below into a new exception of its own - dx_catchall and friends do nothing else - so previous is the chain down to the origin, deep copied and owned by the wrapper; dx::trace::unfold prints it. The constructor overloads below are one signature per combination of the optional leading arguments (previous, function, error, what) ahead of the mandatory frame/file/line, with and without the printf-style comment.

Constructor & Destructor Documentation

exception() [1/34]

dx::exception::exception ( )

inline

Here is the caller graph for this function:

exception() [2/34]

dx::exception::exception ( const exception & copy )

inlinenoexcept

Here is the call graph for this function:

exception() [3/34]

template<typename ... arg_t>

dx::exception::exception ( const exception * previous, const char * function, os_result error, const std::string & what, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

chained complete constructor with variadic comment

Parameters

previous	optional
function	optional
error	optional expanded to unknown or taken from previous
what	optional expanded from error or taken from previous
frame	mandatory
file	mandatory
line	mandatory

Here is the call graph for this function:

exception() [4/34]

dx::exception::exception ( const exception * previous, const char * function, os_result error, const std::string & what, const char * frame, const char * file, unsigned int line, const std::string & comment = "" )

inline

complete base constructor without variadic comment

Here is the call graph for this function:

~exception()

virtual dx::exception::~exception ( )

inlinevirtual

exception() [5/34]

template<typename ... arg_t>

dx::exception::exception ( const exception * previous, const char * function, os_result error, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [6/34]

template<typename ... arg_t>

dx::exception::exception ( const exception * previous, const char * function, const std::string & what, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [7/34]

template<typename ... arg_t>

dx::exception::exception ( const exception * previous, const char * function, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [8/34]

template<typename ... arg_t>

dx::exception::exception ( const exception * previous, os_result error, const std::string & what, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [9/34]

template<typename ... arg_t>

dx::exception::exception ( const exception * previous, os_result error, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [10/34]

template<typename ... arg_t>

dx::exception::exception ( const exception * previous, const std::string & what, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [11/34]

template<typename ... arg_t>

dx::exception::exception ( const exception * previous, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [12/34]

template<typename ... arg_t>

dx::exception::exception ( const char * function, os_result error, const std::string & what, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [13/34]

template<typename ... arg_t>

dx::exception::exception ( const char * function, os_result error, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [14/34]

template<typename ... arg_t>

dx::exception::exception ( const char * function, const std::string & what, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [15/34]

template<typename ... arg_t>

dx::exception::exception ( const char * function, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [16/34]

template<typename ... arg_t>

dx::exception::exception ( os_result error, const std::string & what, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [17/34]

template<typename ... arg_t>

dx::exception::exception ( os_result error, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [18/34]

template<typename ... arg_t>

dx::exception::exception ( const std::string & what, const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [19/34]

template<typename ... arg_t>

dx::exception::exception ( const char * frame, const char * file, unsigned int line, arg_t... args )

inlinenoexcept

Here is the call graph for this function:

exception() [20/34]

dx::exception::exception ( const exception * previous, const char * function, os_result error, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [21/34]

dx::exception::exception ( const exception * previous, const char * function, const std::string & what, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [22/34]

dx::exception::exception ( const exception * previous, const char * function, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [23/34]

dx::exception::exception ( const exception * previous, os_result error, const std::string & what, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [24/34]

dx::exception::exception ( const exception * previous, os_result error, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [25/34]

dx::exception::exception ( const exception * previous, const std::string & what, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [26/34]

dx::exception::exception ( const exception * previous, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [27/34]

dx::exception::exception ( const char * function, os_result error, const std::string & what, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [28/34]

dx::exception::exception ( const char * function, os_result error, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [29/34]

dx::exception::exception ( const char * function, const std::string & what, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [30/34]

dx::exception::exception ( const char * function, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [31/34]

dx::exception::exception ( os_result error, const std::string & what, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [32/34]

dx::exception::exception ( os_result error, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [33/34]

dx::exception::exception ( const std::string & what, const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

exception() [34/34]

dx::exception::exception ( const char * frame, const char * file, unsigned int line )

inlinenoexcept

Here is the call graph for this function:

Member Function Documentation

operator=()

exception & dx::exception::operator= ( const exception & copy )

inlinenoexcept

Here is the call graph for this function:

Member Data Documentation

comment

std::string dx::exception::comment

error

os_result dx::exception::error {}

file

const char* dx::exception::file {}

frame

const char* dx::exception::frame {}

function

const char* dx::exception::function {}

line

unsigned int dx::exception::line {}

owner

bool dx::exception::owner {}

previous

const exception* dx::exception::previous {}

thread

std::string dx::exception::thread {thread::name()}

time

std::time_t dx::exception::time {std::chrono::system_clock::to_time_t (std::chrono::system_clock::now())}

---

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

• dx_exception.h