![]() |
Reference documentation for deal.II version 9.6.0
|
#include <deal.II/base/exceptions.h>
Public Member Functions | |
ExceptionBase () | |
ExceptionBase (const ExceptionBase &exc) | |
virtual | ~ExceptionBase () noexcept override=default |
ExceptionBase | operator= (const ExceptionBase &)=delete |
void | set_fields (const char *file, const int line, const char *function, const char *cond, const char *exc_name) |
virtual const char * | what () const noexcept override |
const char * | get_exc_name () const |
void | print_exc_data (std::ostream &out) const |
virtual void | print_info (std::ostream &out) const |
void | print_stack_trace (std::ostream &out) const |
Protected Attributes | |
const char * | file |
unsigned int | line |
const char * | function |
const char * | cond |
const char * | exc |
int | n_stacktrace_frames |
void * | raw_stacktrace [25] |
Private Member Functions | |
void | generate_message () const |
Private Attributes | |
std::string | what_str |
This class is the base class for all exception classes. Do not use its methods and variables directly since the interface and mechanism may be subject to change. Rather create new exception classes using the DeclException
macro family.
See the Exceptions and assertions topic for more details on this class and what can be done with classes derived from it.
Definition at line 55 of file exceptions.h.
ExceptionBase::ExceptionBase | ( | ) |
Default constructor.
Definition at line 96 of file exceptions.cc.
ExceptionBase::ExceptionBase | ( | const ExceptionBase & | exc | ) |
Copy constructor.
Definition at line 112 of file exceptions.cc.
|
overridevirtualdefaultnoexcept |
Destructor.
|
delete |
Copy operator. This operator is deleted since exception objects are not copyable.
void ExceptionBase::set_fields | ( | const char * | file, |
const int | line, | ||
const char * | function, | ||
const char * | cond, | ||
const char * | exc_name ) |
Set the file name and line of where the exception appeared as well as the violated condition and the name of the exception as a char pointer. This function also populates the stacktrace.
Definition at line 135 of file exceptions.cc.
|
overridevirtualnoexcept |
Override the standard function that returns the description of the error.
Definition at line 160 of file exceptions.cc.
const char * ExceptionBase::get_exc_name | ( | ) | const |
Get exception name.
Definition at line 172 of file exceptions.cc.
void ExceptionBase::print_exc_data | ( | std::ostream & | out | ) | const |
Print out the general part of the error information.
Definition at line 180 of file exceptions.cc.
|
virtual |
Print more specific information about the exception which occurred. Overload this function in your own exception classes.
Reimplemented in internal::NoPermutation< T >, LACExceptions::ExcPETScError, SolverControl::NoConvergence, and StandardExceptions::ExcMPI.
Definition at line 232 of file exceptions.cc.
void ExceptionBase::print_stack_trace | ( | std::ostream & | out | ) | const |
Print a stacktrace, if one has been recorded previously, to the given stream.
Definition at line 240 of file exceptions.cc.
|
private |
Internal function that generates the c_string. Called by what().
Definition at line 341 of file exceptions.cc.
|
protected |
Name of the file this exception happens in.
Definition at line 129 of file exceptions.h.
|
protected |
Line number in this file.
Definition at line 134 of file exceptions.h.
|
protected |
Name of the function, pretty printed.
Definition at line 139 of file exceptions.h.
|
protected |
The violated condition, as a string.
Definition at line 144 of file exceptions.h.
|
protected |
Name of the exception and call sequence.
Definition at line 149 of file exceptions.h.
|
protected |
The number of stacktrace frames that are stored in the following variable. Zero if the system does not support stack traces.
Definition at line 155 of file exceptions.h.
|
protected |
Array of pointers that contains the raw stack trace.
Definition at line 161 of file exceptions.h.
|
mutableprivate |
A pointer to the c_string that will be printed by what(). It is populated by generate_message()
Definition at line 175 of file exceptions.h.