Lumiera  0.pre.03
»edityourfreedom«
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
lumiera::error Namespace Reference

Typedefs

using Config = LumieraError< LERR_(CONFIG), Invalid >
 
using External = LumieraError< LERR_(EXTERNAL)>
 
using Fatal = LumieraError< LERR_(FATAL), Logic >
 
using Flag = LumieraError< LERR_(FLAG), State >
 
using Invalid = LumieraError< LERR_(INVALID)>
 
using Logic = LumieraError< LERR_(LOGIC)>
 
using State = LumieraError< LERR_(STATE)>
 

Classes

class  LumieraError
 Derived specific exceptions within Lumiera's exception hierarchy. More...
 

Functions

void assertion_terminate (const string &location)
 throw an error::Fatal indicating "assertion failure" More...
 
const string default_usermsg (Error *) noexcept
 the message shown to the user per default if an exception reaches one of the top-level catch clauses. More...
 
CStr detailInfo ()
 
void install_unexpectedException_handler ()
 install our own handler for undeclared exceptions. More...
 
 LUMIERA_ERROR_DECLARE (LOGIC)
 contradiction to internal logic assumptions detected More...
 
 LUMIERA_ERROR_DECLARE (FATAL)
 unable to cope with, internal logic floundered More...
 
 LUMIERA_ERROR_DECLARE (CONFIG)
 execution aborted due to misconfiguration More...
 
 LUMIERA_ERROR_DECLARE (STATE)
 unforeseen internal state More...
 
 LUMIERA_ERROR_DECLARE (FLAG)
 non-cleared lumiera errorstate from C code More...
 
 LUMIERA_ERROR_DECLARE (INVALID)
 invalid input or parameters encountered More...
 
 LUMIERA_ERROR_DECLARE (EXTERNAL)
 failure in external service the application relies on More...
 
 LUMIERA_ERROR_DECLARE (ASSERTION)
 assertion failure More...
 
 LUMIERA_ERROR_DECLARE (LIFECYCLE)
 Lifecycle assumptions violated. More...
 
 LUMIERA_ERROR_DECLARE (WRONG_TYPE)
 runtime type mismatch More...
 
 LUMIERA_ERROR_DECLARE (ITER_EXHAUST)
 end of sequence reached More...
 
 LUMIERA_ERROR_DECLARE (CAPACITY)
 predefined fixed storage capacity More...
 
 LUMIERA_ERROR_DECLARE (INDEX_BOUNDS)
 index out of bounds More...
 
 LUMIERA_ERROR_DECLARE (BOTTOM_VALUE)
 invalid or NIL value More...
 
 LUMIERA_ERROR_DECLARE (UNCONNECTED)
 missing connection More...
 
 LUMIERA_ERROR_DECLARE (UNIMPLEMENTED)
 unimplemented feature More...
 
 LUMIERA_ERROR_DEFINE (LOGIC,"internal logic broken")
 
 LUMIERA_ERROR_DEFINE (FATAL,"floundered")
 
 LUMIERA_ERROR_DEFINE (CONFIG,"misconfiguration")
 
 LUMIERA_ERROR_DEFINE (STATE,"unforeseen state")
 
 LUMIERA_ERROR_DEFINE (FLAG,"non-cleared lumiera errorstate")
 
 LUMIERA_ERROR_DEFINE (INVALID,"invalid input or parameters")
 
 LUMIERA_ERROR_DEFINE (EXTERNAL,"failure in external service")
 
 LUMIERA_ERROR_DEFINE (ASSERTION,"assertion failure")
 
 LUMIERA_ERROR_DEFINE (LIFECYCLE,"Lifecycle assumptions violated")
 
 LUMIERA_ERROR_DEFINE (WRONG_TYPE,"runtime type mismatch")
 
 LUMIERA_ERROR_DEFINE (ITER_EXHAUST,"end of sequence reached")
 
 LUMIERA_ERROR_DEFINE (CAPACITY,"predefined fixed storage capacity")
 
 LUMIERA_ERROR_DEFINE (INDEX_BOUNDS,"index out of bounds")
 
 LUMIERA_ERROR_DEFINE (BOTTOM_VALUE,"invalid or NIL value")
 
 LUMIERA_ERROR_DEFINE (UNCONNECTED,"missing connection")
 
 LUMIERA_ERROR_DEFINE (UNIMPLEMENTED,"using a feature not yet implemented....")
 
void lumiera_unexpectedException ()
 global function for handling unknown exceptions encountered at functions declaring not to throw this kind of exception. More...
 

Typedef Documentation

using Logic = LumieraError<LERR_(LOGIC)>

Definition at line 212 of file error.hpp.

using Fatal = LumieraError<LERR_(FATAL), Logic>

Definition at line 213 of file error.hpp.

using State = LumieraError<LERR_(STATE)>

Definition at line 214 of file error.hpp.

using Flag = LumieraError<LERR_(FLAG), State>

Definition at line 215 of file error.hpp.

using Invalid = LumieraError<LERR_(INVALID)>

Definition at line 216 of file error.hpp.

using Config = LumieraError<LERR_(CONFIG), Invalid>

Definition at line 217 of file error.hpp.

using External = LumieraError<LERR_(EXTERNAL)>

Definition at line 218 of file error.hpp.

Function Documentation

const string lumiera::error::default_usermsg ( Error *  )
inlinenoexcept

the message shown to the user per default if an exception reaches one of the top-level catch clauses.

Todo:

to be localised

develop a framework to set more specific yet friendly messages

Definition at line 58 of file error-exception.cpp.

CStr detailInfo ( )
Returns
error detail-info if currently set, a default message else

Definition at line 64 of file error-exception.cpp.

References util::isnil(), and lumiera_error_extra().

Referenced by lumiera::maybeThrow(), and lumiera::throwOnError().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

lumiera::error::LUMIERA_ERROR_DEFINE ( LOGIC  ,
"internal logic broken"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( FATAL  ,
"floundered"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( CONFIG  ,
"misconfiguration"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( STATE  ,
"unforeseen state"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( FLAG  ,
"non-cleared lumiera errorstate"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( INVALID  ,
"invalid input or parameters"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( EXTERNAL  ,
"failure in external service"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( ASSERTION  ,
"assertion failure"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( LIFECYCLE  ,
"Lifecycle assumptions violated"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( WRONG_TYPE  ,
"runtime type mismatch"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( ITER_EXHAUST  ,
"end of sequence reached"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( CAPACITY  ,
"predefined fixed storage capacity"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( INDEX_BOUNDS  ,
"index out of bounds"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( BOTTOM_VALUE  ,
"invalid or NIL value"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( UNCONNECTED  ,
"missing connection"   
)
lumiera::error::LUMIERA_ERROR_DEFINE ( UNIMPLEMENTED  ,
"using a feature not yet implemented...."   
)
void lumiera_unexpectedException ( )
noexcept

global function for handling unknown exceptions encountered at functions declaring not to throw this kind of exception.

Basically, any such event can be considered a severe design flaw; we can just add some diagnostics prior to halting.

Definition at line 179 of file error-exception.cpp.

References util::cStr(), Error::getID(), Error::getUsermsg(), util::isnil(), lumiera_error(), Error::rootCause(), lib::meta::typeStr(), and Error::what().

Referenced by AllocationCluster::~AllocationCluster().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void assertion_terminate ( const string &  location)

throw an error::Fatal indicating "assertion failure"

Definition at line 220 of file error-exception.cpp.

lumiera::error::LUMIERA_ERROR_DECLARE ( LOGIC  )

contradiction to internal logic assumptions detected

lumiera::error::LUMIERA_ERROR_DECLARE ( FATAL  )

unable to cope with, internal logic floundered

lumiera::error::LUMIERA_ERROR_DECLARE ( CONFIG  )

execution aborted due to misconfiguration

lumiera::error::LUMIERA_ERROR_DECLARE ( STATE  )

unforeseen internal state

lumiera::error::LUMIERA_ERROR_DECLARE ( FLAG  )

non-cleared lumiera errorstate from C code

lumiera::error::LUMIERA_ERROR_DECLARE ( INVALID  )

invalid input or parameters encountered

lumiera::error::LUMIERA_ERROR_DECLARE ( EXTERNAL  )

failure in external service the application relies on

lumiera::error::LUMIERA_ERROR_DECLARE ( ASSERTION  )

assertion failure

lumiera::error::LUMIERA_ERROR_DECLARE ( LIFECYCLE  )

Lifecycle assumptions violated.

lumiera::error::LUMIERA_ERROR_DECLARE ( WRONG_TYPE  )

runtime type mismatch

lumiera::error::LUMIERA_ERROR_DECLARE ( ITER_EXHAUST  )

end of sequence reached

lumiera::error::LUMIERA_ERROR_DECLARE ( CAPACITY  )

predefined fixed storage capacity

lumiera::error::LUMIERA_ERROR_DECLARE ( INDEX_BOUNDS  )

index out of bounds

lumiera::error::LUMIERA_ERROR_DECLARE ( BOTTOM_VALUE  )

invalid or NIL value

lumiera::error::LUMIERA_ERROR_DECLARE ( UNCONNECTED  )

missing connection

lumiera::error::LUMIERA_ERROR_DECLARE ( UNIMPLEMENTED  )

unimplemented feature

void lumiera::error::install_unexpectedException_handler ( )

install our own handler for undeclared exceptions.

Will be called automatically ON_BASIC_INIT when linking exception.cpp