Exception types and functions

Exception types and functions. More...

Classes
class	jau::ExceptionBase
class	jau::IllegalArgumentError
class	jau::IllegalStateError
class	jau::IndexOutOfBoundsError
class	jau::InternalError
class	jau::IOError
class	jau::LogicError
class	jau::LogicErrorBase
class	jau::NotImplementedException
class	jau::NullPointerException
class	jau::OutOfMemoryError
class	jau::RuntimeException
class	jau::RuntimeExceptionBase
class	jau::RuntimeSystemException
class	jau::RuntimeSystemExceptionBase
class	jau::UnsupportedOperationException

Typedefs
typedef jau::function< bool(const std::exception &)>	jau::exception_handler_t

Functions
	jau::ExceptionBase::ExceptionBase (const ExceptionBase &o) noexcept=default
	jau::ExceptionBase::ExceptionBase (ExceptionBase &&o) noexcept=default
	jau::ExceptionBase::ExceptionBase (std::string &&type, std::string const &m, const char *file, int line) noexcept
	jau::IllegalArgumentError::IllegalArgumentError (std::string &&type, std::string const &m, const char *file, int line) noexcept
	jau::IllegalArgumentError::IllegalArgumentError (std::string const &m, const char *file, int line) noexcept
	jau::IllegalStateError::IllegalStateError (std::string &&type, std::string const &m, const char *file, int line) noexcept
	jau::IllegalStateError::IllegalStateError (std::string const &m, const char *file, int line) noexcept
	jau::IndexOutOfBoundsError::IndexOutOfBoundsError (const char *file, int line, std::string &&type, std::string const &m) noexcept
	jau::IndexOutOfBoundsError::IndexOutOfBoundsError (const std::size_t index, const std::size_t count, const std::size_t length, const char *file, int line) noexcept
	jau::IndexOutOfBoundsError::IndexOutOfBoundsError (const std::size_t index, const std::size_t length, const char *file, int line) noexcept
	jau::IndexOutOfBoundsError::IndexOutOfBoundsError (const std::string &index_s, const std::string &length_s, const char *file, int line) noexcept
	jau::IndexOutOfBoundsError::IndexOutOfBoundsError (const std::string &msg, const std::size_t index, const std::size_t length, const char *file, int line) noexcept
	jau::InternalError::InternalError (std::string const &m, const char *file, int line) noexcept
	jau::IOError::IOError (std::string const &m, const char *file, int line, const std::error_code &ec=std::io_errc::stream) noexcept
	jau::LogicError::LogicError (const LogicError &o) noexcept=default
	jau::LogicError::LogicError (LogicError &&o) noexcept=default
	jau::LogicError::LogicError (std::string &&type, std::string const &m, const char *file, int line) noexcept
	jau::LogicError::LogicError (std::string const &m, const char *file, int line) noexcept
	jau::LogicErrorBase::LogicErrorBase (const LogicErrorBase &o) noexcept=default
	jau::LogicErrorBase::LogicErrorBase (LogicErrorBase &&o) noexcept=default
	jau::LogicErrorBase::LogicErrorBase (std::string &&type, std::string const &m, const char *file, int line) noexcept
	jau::NotImplementedException::NotImplementedException (std::string const &m, const char *file, int line) noexcept
	jau::NullPointerException::NullPointerException (std::string const &m, const char *file, int line) noexcept
	jau::OutOfMemoryError::OutOfMemoryError (std::string const &m, const char *file, int line)
	jau::RuntimeException::RuntimeException (const RuntimeException &o) noexcept=default
	jau::RuntimeException::RuntimeException (RuntimeException &&o) noexcept=default
	jau::RuntimeException::RuntimeException (std::string &&type, std::string const &m, const char *file, int line) noexcept
	jau::RuntimeException::RuntimeException (std::string const &m, const char *file, int line) noexcept
	jau::RuntimeExceptionBase::RuntimeExceptionBase (const RuntimeExceptionBase &o) noexcept=default
	jau::RuntimeExceptionBase::RuntimeExceptionBase (RuntimeExceptionBase &&o) noexcept=default
	jau::RuntimeExceptionBase::RuntimeExceptionBase (std::string &&type, std::string const &m, const char *file, int line) noexcept
	jau::RuntimeSystemException::RuntimeSystemException (const RuntimeSystemException &o) noexcept=default
	jau::RuntimeSystemException::RuntimeSystemException (const std::error_code &ec, std::string const &m, const char *file, int line) noexcept
	jau::RuntimeSystemException::RuntimeSystemException (RuntimeSystemException &&o) noexcept=default
	jau::RuntimeSystemException::RuntimeSystemException (std::string &&type, const std::error_code &ec, std::string const &m, const char *file, int line) noexcept
	jau::RuntimeSystemExceptionBase::RuntimeSystemExceptionBase (const RuntimeSystemExceptionBase &o) noexcept=default
	jau::RuntimeSystemExceptionBase::RuntimeSystemExceptionBase (RuntimeSystemExceptionBase &&o) noexcept=default
	jau::RuntimeSystemExceptionBase::RuntimeSystemExceptionBase (std::string &&type, const std::error_code &ec, std::string const &m, const char *file, int line) noexcept
	jau::UnsupportedOperationException::UnsupportedOperationException (std::string const &m, const char *file, int line) noexcept
virtual	jau::ExceptionBase::~ExceptionBase () noexcept=default
	jau::LogicError::~LogicError () noexcept override=default
	jau::LogicErrorBase::~LogicErrorBase () noexcept override=default
	jau::RuntimeException::~RuntimeException () noexcept override=default
	jau::RuntimeExceptionBase::~RuntimeExceptionBase () noexcept override=default
	jau::RuntimeSystemException::~RuntimeSystemException () noexcept override=default
	jau::RuntimeSystemExceptionBase::~RuntimeSystemExceptionBase () noexcept override=default
const std::string &	jau::ExceptionBase::backtrace () const noexcept
	Returns optional whole backtrace.
const std::string &	jau::ExceptionBase::brief_message () const noexcept
	Returns brief message.
const std::error_code &	jau::RuntimeSystemExceptionBase::code () const noexcept
bool	jau::handle_exception (std::exception_ptr eptr)
	Handle given optional exception (nullable std::exception_ptr) and send std::exception::what() message to stderr
bool	jau::handle_exception (std::exception_ptr eptr, jau::exception_handler_t &eh)
	Handle given optional exception (nullable std::exception_ptr) and calls exception_handler_t.
	jau::ExceptionBase::operator const std::string & () const noexcept
	Allow conversion to const std::string& using brief_message(), as required by Catch2's REQUIRE_THROWS_MATCHES
std::ostream &	jau::ExceptionBase::operator<< (std::ostream &out) noexcept
ExceptionBase &	jau::ExceptionBase::operator= (const ExceptionBase &o) noexcept=default
ExceptionBase &	jau::ExceptionBase::operator= (ExceptionBase &&o) noexcept=default
LogicError &	jau::LogicError::operator= (const LogicError &o) noexcept=default
LogicError &	jau::LogicError::operator= (LogicError &&o) noexcept=default
LogicErrorBase &	jau::LogicErrorBase::operator= (const LogicErrorBase &o) noexcept=default
LogicErrorBase &	jau::LogicErrorBase::operator= (LogicErrorBase &&o) noexcept=default
RuntimeException &	jau::RuntimeException::operator= (const RuntimeException &o) noexcept=default
RuntimeException &	jau::RuntimeException::operator= (RuntimeException &&o) noexcept=default
RuntimeExceptionBase &	jau::RuntimeExceptionBase::operator= (const RuntimeExceptionBase &o) noexcept=default
RuntimeExceptionBase &	jau::RuntimeExceptionBase::operator= (RuntimeExceptionBase &&o) noexcept=default
RuntimeSystemException &	jau::RuntimeSystemException::operator= (const RuntimeSystemException &o) noexcept=default
RuntimeSystemException &	jau::RuntimeSystemException::operator= (RuntimeSystemException &&o) noexcept=default
RuntimeSystemExceptionBase &	jau::RuntimeSystemExceptionBase::operator= (const RuntimeSystemExceptionBase &o) noexcept=default
RuntimeSystemExceptionBase &	jau::RuntimeSystemExceptionBase::operator= (RuntimeSystemExceptionBase &&o) noexcept=default
virtual const char *	jau::ExceptionBase::what () const noexcept
const char *	jau::IllegalArgumentError::what () const noexcept override
const char *	jau::IllegalStateError::what () const noexcept override
const char *	jau::IndexOutOfBoundsError::what () const noexcept override
const char *	jau::IOError::what () const noexcept override
const char *	jau::LogicError::what () const noexcept override
const char *	jau::OutOfMemoryError::what () const noexcept override
const char *	jau::RuntimeException::what () const noexcept override
const char *	jau::RuntimeSystemException::what () const noexcept override
const std::string &	jau::ExceptionBase::whole_message () const noexcept
	Returns brief message and optional whole backtrace, i.e.

Variables
std::error_code	jau::RuntimeSystemExceptionBase::m_ec

Detailed Description

Exception types and functions.

Typedef Documentation

exception_handler_t

typedef jau::function<bool(const std::exception &)> jau::exception_handler_t

Definition at line 61 of file exceptions.hpp.

Function Documentation

handle_exception() [1/2]

bool jau::handle_exception ( std::exception_ptr eptr )

inline

Handle given optional exception (nullable std::exception_ptr) and send std::exception::what() message to stderr

Parameters

eptr	contains optional exception, may be nullptr

Returns

true if eptr contained an exception pointer, message was not nullptr

Definition at line 49 of file exceptions.hpp.

Here is the caller graph for this function:

handle_exception() [2/2]

bool jau::handle_exception ( std::exception_ptr eptr, jau::exception_handler_t & eh )

inline

Handle given optional exception (nullable std::exception_ptr) and calls exception_handler_t.

Parameters

eptr	contains optional exception, may be nullptr
eh	exception_handler_t to process an eventual exception

Returns

true if eptr contained an exception pointer, exception_handler_t result is returned. Otherwise false (no exception).

Definition at line 69 of file exceptions.hpp.

ExceptionBase() [1/3]

jau::ExceptionBase::ExceptionBase ( std::string && type, std::string const & m, const char * file, int line )

protectednoexcept

Definition at line 426 of file basic_types.cpp.

Here is the caller graph for this function:

~ExceptionBase()

virtual jau::ExceptionBase::~ExceptionBase ( )

virtualdefaultnoexcept

ExceptionBase() [2/3]

jau::ExceptionBase::ExceptionBase ( const ExceptionBase & o )

defaultnoexcept

ExceptionBase() [3/3]

jau::ExceptionBase::ExceptionBase ( ExceptionBase && o )

defaultnoexcept

operator=() [1/14]

ExceptionBase & jau::ExceptionBase::operator= ( const ExceptionBase & o )

defaultnoexcept

operator=() [2/14]

ExceptionBase & jau::ExceptionBase::operator= ( ExceptionBase && o )

defaultnoexcept

brief_message()

const std::string & jau::ExceptionBase::brief_message ( ) const

inlinenoexcept

Returns brief message.

Definition at line 111 of file exceptions.hpp.

Here is the caller graph for this function:

backtrace()

const std::string & jau::ExceptionBase::backtrace ( ) const

inlinenoexcept

Returns optional whole backtrace.

Definition at line 113 of file exceptions.hpp.

whole_message()

const std::string & jau::ExceptionBase::whole_message ( ) const

inlinenoexcept

Returns brief message and optional whole backtrace, i.e.

std::exception::what() string.

Definition at line 115 of file exceptions.hpp.

Here is the caller graph for this function:

operator const std::string &()

jau::ExceptionBase::operator const std::string & ( ) const

inlinenoexcept

Allow conversion to const std::string& using brief_message(), as required by Catch2's REQUIRE_THROWS_MATCHES

Definition at line 118 of file exceptions.hpp.

operator<<()

std::ostream & jau::ExceptionBase::operator<< ( std::ostream & out )

inlinenoexcept

Definition at line 120 of file exceptions.hpp.

what() [1/9]

virtual const char * jau::ExceptionBase::what ( ) const

inlinevirtualnoexcept

Reimplemented in jau::IllegalArgumentError, jau::IllegalStateError, jau::IndexOutOfBoundsError, jau::IOError, jau::LogicError, jau::math::MathDomainError, jau::math::MathError, jau::math::MathInexactError, jau::math::MathOverflowError, jau::math::MathUnderflowError, jau::OutOfMemoryError, jau::RuntimeException, and jau::RuntimeSystemException.

Definition at line 124 of file exceptions.hpp.

RuntimeExceptionBase() [1/3]

jau::RuntimeExceptionBase::RuntimeExceptionBase ( std::string && type, std::string const & m, const char * file, int line )

inlineprotectednoexcept

Definition at line 130 of file exceptions.hpp.

Here is the caller graph for this function:

~RuntimeExceptionBase()

jau::RuntimeExceptionBase::~RuntimeExceptionBase ( )

overridedefaultnoexcept

RuntimeExceptionBase() [2/3]

jau::RuntimeExceptionBase::RuntimeExceptionBase ( const RuntimeExceptionBase & o )

defaultnoexcept

RuntimeExceptionBase() [3/3]

jau::RuntimeExceptionBase::RuntimeExceptionBase ( RuntimeExceptionBase && o )

defaultnoexcept

operator=() [3/14]

RuntimeExceptionBase & jau::RuntimeExceptionBase::operator= ( const RuntimeExceptionBase & o )

defaultnoexcept

operator=() [4/14]

RuntimeExceptionBase & jau::RuntimeExceptionBase::operator= ( RuntimeExceptionBase && o )

defaultnoexcept

LogicErrorBase() [1/3]

jau::LogicErrorBase::LogicErrorBase ( std::string && type, std::string const & m, const char * file, int line )

inlineprotectednoexcept

Definition at line 143 of file exceptions.hpp.

Here is the caller graph for this function:

~LogicErrorBase()

jau::LogicErrorBase::~LogicErrorBase ( )

overridedefaultnoexcept

LogicErrorBase() [2/3]

jau::LogicErrorBase::LogicErrorBase ( const LogicErrorBase & o )

defaultnoexcept

LogicErrorBase() [3/3]

jau::LogicErrorBase::LogicErrorBase ( LogicErrorBase && o )

defaultnoexcept

operator=() [5/14]

LogicErrorBase & jau::LogicErrorBase::operator= ( const LogicErrorBase & o )

defaultnoexcept

operator=() [6/14]

LogicErrorBase & jau::LogicErrorBase::operator= ( LogicErrorBase && o )

defaultnoexcept

RuntimeSystemExceptionBase() [1/3]

jau::RuntimeSystemExceptionBase::RuntimeSystemExceptionBase ( std::string && type, const std::error_code & ec, std::string const & m, const char * file, int line )

inlineprotectednoexcept

Definition at line 157 of file exceptions.hpp.

Here is the caller graph for this function:

~RuntimeSystemExceptionBase()

jau::RuntimeSystemExceptionBase::~RuntimeSystemExceptionBase ( )

overridedefaultnoexcept

RuntimeSystemExceptionBase() [2/3]

jau::RuntimeSystemExceptionBase::RuntimeSystemExceptionBase ( const RuntimeSystemExceptionBase & o )

defaultnoexcept

RuntimeSystemExceptionBase() [3/3]

jau::RuntimeSystemExceptionBase::RuntimeSystemExceptionBase ( RuntimeSystemExceptionBase && o )

defaultnoexcept

operator=() [7/14]

RuntimeSystemExceptionBase & jau::RuntimeSystemExceptionBase::operator= ( const RuntimeSystemExceptionBase & o )

defaultnoexcept

operator=() [8/14]

RuntimeSystemExceptionBase & jau::RuntimeSystemExceptionBase::operator= ( RuntimeSystemExceptionBase && o )

defaultnoexcept

code()

const std::error_code & jau::RuntimeSystemExceptionBase::code ( ) const

inlinenoexcept

Definition at line 168 of file exceptions.hpp.

Here is the caller graph for this function:

OutOfMemoryError()

jau::OutOfMemoryError::OutOfMemoryError ( std::string const & m, const char * file, int line )

inline

Definition at line 174 of file exceptions.hpp.

what() [2/9]

const char * jau::OutOfMemoryError::what ( ) const

inlineoverridevirtualnoexcept

Reimplemented from jau::ExceptionBase.

Definition at line 177 of file exceptions.hpp.

RuntimeException() [1/4]

jau::RuntimeException::RuntimeException ( std::string && type, std::string const & m, const char * file, int line )

inlineprotectednoexcept

Definition at line 185 of file exceptions.hpp.

Here is the caller graph for this function:

RuntimeException() [2/4]

jau::RuntimeException::RuntimeException ( std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 189 of file exceptions.hpp.

~RuntimeException()

jau::RuntimeException::~RuntimeException ( )

overridedefaultnoexcept

RuntimeException() [3/4]

jau::RuntimeException::RuntimeException ( const RuntimeException & o )

defaultnoexcept

RuntimeException() [4/4]

jau::RuntimeException::RuntimeException ( RuntimeException && o )

defaultnoexcept

operator=() [9/14]

RuntimeException & jau::RuntimeException::operator= ( const RuntimeException & o )

defaultnoexcept

operator=() [10/14]

RuntimeException & jau::RuntimeException::operator= ( RuntimeException && o )

defaultnoexcept

what() [3/9]

const char * jau::RuntimeException::what ( ) const

inlineoverridevirtualnoexcept

Reimplemented from jau::ExceptionBase.

Definition at line 200 of file exceptions.hpp.

Here is the caller graph for this function:

LogicError() [1/4]

jau::LogicError::LogicError ( std::string && type, std::string const & m, const char * file, int line )

inlineprotectednoexcept

Definition at line 207 of file exceptions.hpp.

Here is the caller graph for this function:

LogicError() [2/4]

jau::LogicError::LogicError ( std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 211 of file exceptions.hpp.

~LogicError()

jau::LogicError::~LogicError ( )

overridedefaultnoexcept

LogicError() [3/4]

jau::LogicError::LogicError ( const LogicError & o )

defaultnoexcept

LogicError() [4/4]

jau::LogicError::LogicError ( LogicError && o )

defaultnoexcept

operator=() [11/14]

LogicError & jau::LogicError::operator= ( const LogicError & o )

defaultnoexcept

operator=() [12/14]

LogicError & jau::LogicError::operator= ( LogicError && o )

defaultnoexcept

what() [4/9]

const char * jau::LogicError::what ( ) const

inlineoverridevirtualnoexcept

Reimplemented from jau::ExceptionBase.

Definition at line 221 of file exceptions.hpp.

Here is the caller graph for this function:

RuntimeSystemException() [1/4]

jau::RuntimeSystemException::RuntimeSystemException ( std::string && type, const std::error_code & ec, std::string const & m, const char * file, int line )

inlineprotectednoexcept

Definition at line 228 of file exceptions.hpp.

Here is the caller graph for this function:

RuntimeSystemException() [2/4]

jau::RuntimeSystemException::RuntimeSystemException ( const std::error_code & ec, std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 232 of file exceptions.hpp.

~RuntimeSystemException()

jau::RuntimeSystemException::~RuntimeSystemException ( )

overridedefaultnoexcept

RuntimeSystemException() [3/4]

jau::RuntimeSystemException::RuntimeSystemException ( const RuntimeSystemException & o )

defaultnoexcept

RuntimeSystemException() [4/4]

jau::RuntimeSystemException::RuntimeSystemException ( RuntimeSystemException && o )

defaultnoexcept

operator=() [13/14]

RuntimeSystemException & jau::RuntimeSystemException::operator= ( const RuntimeSystemException & o )

defaultnoexcept

operator=() [14/14]

RuntimeSystemException & jau::RuntimeSystemException::operator= ( RuntimeSystemException && o )

defaultnoexcept

what() [5/9]

const char * jau::RuntimeSystemException::what ( ) const

inlineoverridevirtualnoexcept

Reimplemented from jau::ExceptionBase.

Definition at line 242 of file exceptions.hpp.

Here is the caller graph for this function:

IndexOutOfBoundsError() [1/5]

jau::IndexOutOfBoundsError::IndexOutOfBoundsError ( const char * file, int line, std::string && type, std::string const & m )

inlineprotectednoexcept

Definition at line 250 of file exceptions.hpp.

Here is the caller graph for this function:

IndexOutOfBoundsError() [2/5]

jau::IndexOutOfBoundsError::IndexOutOfBoundsError ( const std::size_t index, const std::size_t length, const char * file, int line )

inlinenoexcept

Definition at line 254 of file exceptions.hpp.

IndexOutOfBoundsError() [3/5]

jau::IndexOutOfBoundsError::IndexOutOfBoundsError ( const std::string & msg, const std::size_t index, const std::size_t length, const char * file, int line )

inlinenoexcept

Definition at line 257 of file exceptions.hpp.

IndexOutOfBoundsError() [4/5]

jau::IndexOutOfBoundsError::IndexOutOfBoundsError ( const std::string & index_s, const std::string & length_s, const char * file, int line )

inlinenoexcept

Definition at line 260 of file exceptions.hpp.

IndexOutOfBoundsError() [5/5]

jau::IndexOutOfBoundsError::IndexOutOfBoundsError ( const std::size_t index, const std::size_t count, const std::size_t length, const char * file, int line )

inlinenoexcept

Definition at line 263 of file exceptions.hpp.

what() [6/9]

const char * jau::IndexOutOfBoundsError::what ( ) const

inlineoverridevirtualnoexcept

Reimplemented from jau::ExceptionBase.

Definition at line 266 of file exceptions.hpp.

IllegalArgumentError() [1/2]

jau::IllegalArgumentError::IllegalArgumentError ( std::string && type, std::string const & m, const char * file, int line )

inlineprotectednoexcept

Definition at line 274 of file exceptions.hpp.

Here is the caller graph for this function:

IllegalArgumentError() [2/2]

jau::IllegalArgumentError::IllegalArgumentError ( std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 278 of file exceptions.hpp.

what() [7/9]

const char * jau::IllegalArgumentError::what ( ) const

inlineoverridevirtualnoexcept

Reimplemented from jau::ExceptionBase.

Definition at line 281 of file exceptions.hpp.

IllegalStateError() [1/2]

jau::IllegalStateError::IllegalStateError ( std::string && type, std::string const & m, const char * file, int line )

inlineprotectednoexcept

Definition at line 289 of file exceptions.hpp.

Here is the caller graph for this function:

IllegalStateError() [2/2]

jau::IllegalStateError::IllegalStateError ( std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 293 of file exceptions.hpp.

what() [8/9]

const char * jau::IllegalStateError::what ( ) const

inlineoverridevirtualnoexcept

Reimplemented from jau::ExceptionBase.

Definition at line 296 of file exceptions.hpp.

IOError()

jau::IOError::IOError ( std::string const & m, const char * file, int line, const std::error_code & ec = std::io_errc::stream )

inlinenoexcept

Definition at line 304 of file exceptions.hpp.

what() [9/9]

const char * jau::IOError::what ( ) const

inlineoverridevirtualnoexcept

Reimplemented from jau::ExceptionBase.

Definition at line 307 of file exceptions.hpp.

InternalError()

jau::InternalError::InternalError ( std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 314 of file exceptions.hpp.

NotImplementedException()

jau::NotImplementedException::NotImplementedException ( std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 320 of file exceptions.hpp.

NullPointerException()

jau::NullPointerException::NullPointerException ( std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 326 of file exceptions.hpp.

UnsupportedOperationException()

jau::UnsupportedOperationException::UnsupportedOperationException ( std::string const & m, const char * file, int line )

inlinenoexcept

Definition at line 332 of file exceptions.hpp.

Variable Documentation

m_ec

std::error_code jau::RuntimeSystemExceptionBase::m_ec

protected

Definition at line 156 of file exceptions.hpp.