Cantera
2.3.0
|
Base class for exceptions thrown by Cantera classes. More...
#include <ctexceptions.h>
Public Member Functions | |
template<typename... Args> | |
CanteraError (const std::string &procedure, const std::string &msg, const Args &... args) | |
Normal Constructor for the CanteraError base class. More... | |
virtual | ~CanteraError () throw () |
Destructor for base class does nothing. More... | |
const char * | what () const throw () |
Get a description of the error. More... | |
void | save () |
Function to put this error onto Cantera's error stack. More... | |
virtual std::string | getMessage () const |
Method overridden by derived classes to format the error message. More... | |
virtual std::string | getClass () const |
Method overridden by derived classes to indicate their type. More... | |
Protected Member Functions | |
CanteraError () | |
Protected default constructor discourages throwing errors containing no information. More... | |
CanteraError (const std::string &procedure) | |
Constructor used by derived classes that override getMessage() More... | |
Protected Attributes | |
std::string | procedure_ |
The name of the procedure where the exception occurred. More... | |
std::string | formattedMessage_ |
Formatted message returned by what() More... | |
Private Attributes | |
std::string | msg_ |
Message associated with the exception. More... | |
bool | saved_ |
Exception has already been saved to Cantera's error stack. More... | |
Base class for exceptions thrown by Cantera classes.
This class is the base class for exceptions thrown by Cantera. It inherits from std::exception so that normal error handling operations from applications may automatically handle the errors in their own way.
Definition at line 65 of file ctexceptions.h.
|
inline |
Normal Constructor for the CanteraError base class.
procedure | String name for the function within which the error was generated. |
msg | Descriptive string describing the type of error message. This can be a fmt-style format string (i.e. using curly braces to indicate fields), which will be used with additional arguments to generate a formatted error message |
args | Arguments which will be used to interpolate the format string |
Definition at line 79 of file ctexceptions.h.
References CanteraError::msg_.
|
inlinevirtual |
Destructor for base class does nothing.
Definition at line 92 of file ctexceptions.h.
|
inlineprotected |
Protected default constructor discourages throwing errors containing no information.
Definition at line 112 of file ctexceptions.h.
|
explicitprotected |
Constructor used by derived classes that override getMessage()
Definition at line 19 of file ctexceptions.cpp.
const char * what | ( | ) | const | |
throw | ( | |||
) |
Get a description of the error.
Definition at line 34 of file ctexceptions.cpp.
References CanteraError::formattedMessage_, CanteraError::getClass(), CanteraError::getMessage(), and CanteraError::procedure_.
Referenced by FuncEval::eval_nothrow().
void save | ( | ) |
Function to put this error onto Cantera's error stack.
To be removed after Cantera 2.3.
Definition at line 25 of file ctexceptions.cpp.
References Application::addError(), CanteraError::getMessage(), Application::Instance(), CanteraError::procedure_, CanteraError::saved_, and Cantera::warn_deprecated().
|
virtual |
Method overridden by derived classes to format the error message.
Reimplemented in IndexError, ArraySizeError, and XML_Error.
Definition at line 54 of file ctexceptions.cpp.
References CanteraError::msg_.
Referenced by ChemEquil::equilibrate(), FuncEval::eval_nothrow(), CanteraError::save(), and CanteraError::what().
|
inlinevirtual |
Method overridden by derived classes to indicate their type.
Reimplemented in NotImplementedError, IndexError, ArraySizeError, XML_NoChild, and XML_TagMismatch.
Definition at line 105 of file ctexceptions.h.
Referenced by CanteraError::what().
|
protected |
The name of the procedure where the exception occurred.
Definition at line 118 of file ctexceptions.h.
Referenced by CanteraError::save(), and CanteraError::what().
|
mutableprotected |
Formatted message returned by what()
Definition at line 119 of file ctexceptions.h.
Referenced by CanteraError::what().
|
private |
Message associated with the exception.
Definition at line 122 of file ctexceptions.h.
Referenced by CanteraError::CanteraError(), and CanteraError::getMessage().
|
private |
Exception has already been saved to Cantera's error stack.
Definition at line 123 of file ctexceptions.h.
Referenced by CanteraError::save().