mirror of
https://github.com/XRPLF/rippled.git
synced 2026-04-29 15:37:57 +00:00
59 lines
1.3 KiB
C++
59 lines
1.3 KiB
C++
#ifndef XRPL_BASICS_CONTRACT_H_INCLUDED
|
|
#define XRPL_BASICS_CONTRACT_H_INCLUDED
|
|
|
|
#include <xrpl/basics/sanitizers.h>
|
|
#include <xrpl/beast/type_name.h>
|
|
|
|
#include <exception>
|
|
#include <string>
|
|
#include <utility>
|
|
|
|
namespace xrpl {
|
|
|
|
/* Programming By Contract
|
|
|
|
This routines are used when checking
|
|
preconditions, postconditions, and invariants.
|
|
*/
|
|
|
|
/** Generates and logs a call stack */
|
|
void
|
|
LogThrow(std::string const& title);
|
|
|
|
/** Rethrow the exception currently being handled.
|
|
|
|
When called from within a catch block, it will pass
|
|
control to the next matching exception handler, if any.
|
|
Otherwise, std::terminate will be called.
|
|
*/
|
|
[[noreturn]] inline void XRPL_NO_SANITIZE_ADDRESS
|
|
Rethrow()
|
|
{
|
|
LogThrow("Re-throwing exception");
|
|
throw;
|
|
}
|
|
|
|
template <class E, class... Args>
|
|
[[noreturn]] inline void XRPL_NO_SANITIZE_ADDRESS
|
|
Throw(Args&&... args)
|
|
{
|
|
static_assert(
|
|
std::is_convertible<E*, std::exception*>::value,
|
|
"Exception must derive from std::exception.");
|
|
|
|
E e(std::forward<Args>(args)...);
|
|
LogThrow(
|
|
std::string(
|
|
"Throwing exception of type " + beast::type_name<E>() + ": ") +
|
|
e.what());
|
|
throw e;
|
|
}
|
|
|
|
/** Called when faulty logic causes a broken invariant. */
|
|
[[noreturn]] void
|
|
LogicError(std::string const& how) noexcept;
|
|
|
|
} // namespace xrpl
|
|
|
|
#endif
|