mirror of
https://github.com/matrix-construct/construct
synced 2024-11-25 16:22:35 +01:00
70 lines
3.4 KiB
C++
70 lines
3.4 KiB
C++
// The Construct
|
|
//
|
|
// Copyright (C) The Construct Developers, Authors & Contributors
|
|
// Copyright (C) 2016-2020 Jason Volk <jason@zemos.net>
|
|
//
|
|
// Permission to use, copy, modify, and/or distribute this software for any
|
|
// purpose with or without fee is hereby granted, provided that the above
|
|
// copyright notice and this permission notice is present in all copies. The
|
|
// full license for this software is available in the LICENSE file.
|
|
|
|
#pragma once
|
|
#define HAVE_IRCD_PANIC_H
|
|
|
|
namespace ircd
|
|
{
|
|
struct terminate;
|
|
|
|
void panicking(const std::exception &) noexcept;
|
|
void panicking(const std::exception_ptr &) noexcept;
|
|
void _aborting_() noexcept;
|
|
}
|
|
|
|
/// Always prefer ircd::terminate() to std::terminate() for all project code.
|
|
struct ircd::terminate
|
|
{
|
|
[[noreturn]] terminate(const std::exception &) noexcept;
|
|
[[noreturn]] terminate(std::exception_ptr) noexcept;
|
|
[[noreturn]] terminate(const string_view &) noexcept;
|
|
[[noreturn]] terminate() noexcept;
|
|
};
|
|
|
|
/// Creates a panic-type exception.
|
|
///
|
|
/// Throwable which will terminate on construction in debug mode but throw
|
|
/// normally in release mode. Ideally this should never be thrown in release
|
|
/// mode because the termination in debug means a test can never pass and
|
|
/// the triggering callsite should be eliminated. Nevertheless it throws
|
|
/// normally in release mode for recovering at an exception handler.
|
|
#define IRCD_PANICKING(parent, name) \
|
|
struct name \
|
|
:parent \
|
|
{ \
|
|
template<class... args> \
|
|
name(const string_view &fmt, args&&... ap) noexcept \
|
|
:parent{generate_skip} \
|
|
{ \
|
|
generate(#name, fmt, ircd::va_rtti{std::forward<args>(ap)...}); \
|
|
ircd::panicking(*this); \
|
|
} \
|
|
\
|
|
template<class... args> \
|
|
name(const string_view &fmt = " ") noexcept \
|
|
:parent{generate_skip} \
|
|
{ \
|
|
generate(#name, fmt, ircd::va_rtti{}); \
|
|
ircd::panicking(*this); \
|
|
} \
|
|
\
|
|
name(generate_skip_t) \
|
|
:parent{generate_skip} \
|
|
{ \
|
|
} \
|
|
};
|
|
|
|
namespace ircd
|
|
{
|
|
// panic errors; see IRCD_PANICKING docs.
|
|
IRCD_PANICKING(exception, panic)
|
|
IRCD_PANICKING(panic, not_implemented)
|
|
}
|