From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Tue, 2 May 2023 23:49:49 +0000 (-0600)
Subject: Introduce an exception to be used by user callbacks.
X-Git-Tag: v9.5.0-rc1~247^2~8
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=91ffdc00dbb56279505f38986865b0b2525e9346;p=dealii.git

Introduce an exception to be used by user callbacks.
---

diff --git a/include/deal.II/base/exceptions.h b/include/deal.II/base/exceptions.h
index 2b9a7c14a1..8a8f817aab 100644
--- a/include/deal.II/base/exceptions.h
+++ b/include/deal.II/base/exceptions.h
@@ -1272,6 +1272,19 @@ namespace StandardExceptions
     const int error_code;
   };
 #endif // DEAL_II_TRILINOS_WITH_SEACAS
+
+  /**
+   * An exception to be thrown in user call-backs. See the glossary entry
+   * on user call-back functions for more information.
+   */
+  DeclExceptionMsg(
+    RecoverableUserCallbackError,
+    "A user call-back function encountered a recoverable error, "
+    "but the underlying library that called the call-back did not "
+    "manage to recover from the error and aborted its operation."
+    "\n\n"
+    "See the glossary entry on user call-back functions for more "
+    "information.");
 } /*namespace StandardExceptions*/