diff options
Diffstat (limited to 'Source/ablastr/utils/TextMsg.H')
-rw-r--r-- | Source/ablastr/utils/TextMsg.H | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/Source/ablastr/utils/TextMsg.H b/Source/ablastr/utils/TextMsg.H index 9dc55cac6..6fa7b28a9 100644 --- a/Source/ablastr/utils/TextMsg.H +++ b/Source/ablastr/utils/TextMsg.H @@ -49,12 +49,33 @@ namespace ablastr::utils::TextMsg std::string Warn (const std::string &msg, const bool do_text_wrapping = true); + /** \brief This function is a wrapper around amrex::Assert, designed to ensure the uniform + * formatting of the error messages. The function is designed to be used via the + * ABLASTR_ALWAYS_ASSERT_WITH_MESSAGE(EX,MSG) macro. + * + * @param[in] ex the text of the failed assertion + * @param[in] file the file where the assertion failed + * @param[in] line the line where the assertion failed + * @param[in] msg the error message + */ void Assert (const char *ex, const char *file, const int line, const std::string &msg); + /** \brief This function is a wrapper around amrex::Abort, designed to ensure the uniform + * formatting of the error messages. The function is designed to be used via the + * ABLASTR_ABORT_WITH_MESSAGE(MSG) macro. + * + * @param[in] file the file where abort was called + * @param[in] line the line here abort was called + * @param[in] msg the error message + */ + void + Abort (const char *file, const int line, const std::string &msg); + } // namespace ablastr::utils::TextMsg #define ABLASTR_ALWAYS_ASSERT_WITH_MESSAGE(EX,MSG) (EX)?((void)0) : ablastr::utils::TextMsg::Assert( # EX , __FILE__, __LINE__ , MSG) +#define ABLASTR_ABORT_WITH_MESSAGE(MSG) ablastr::utils::TextMsg::Abort( __FILE__, __LINE__ , MSG) #endif // ABLASTR_TEXT_MSG_H_ |