exceptions.h

Go to the documentation of this file.

#pragma once
 
#include <stdexcept>
#include <string>
#include <string_view>
#include <format>
#include <type_traits>
#include <utility>
 
namespace ph
{
 
// Note: When adding new base types, the implementation of `CPhotonException` needs to be updated.
 
// A convenient "catch all" (including std exceptions) type when handling exceptions
using Exception = std::exception;
 
class RuntimeException : public std::runtime_error
{
public:
    explicit RuntimeException(const std::string& message);
    explicit RuntimeException(const char* message);
    inline ~RuntimeException() override = default;
 
    virtual std::string whatStr() const;
};
 
class LogicalException : public std::logic_error
{
public:
    explicit LogicalException(const std::string& message);
    explicit LogicalException(const char* message);
    inline ~LogicalException() override = default;
 
    virtual std::string whatStr() const;
};
 
class NumericException : public RuntimeException
{
public:
    using RuntimeException::RuntimeException;
};
 
class OverflowException : public NumericException
{
public:
    using NumericException::NumericException;
};
 
class UninitializedObjectException : public LogicalException
{
public:
    using LogicalException::LogicalException;
};
 
class IllegalOperationException : public LogicalException
{
public:
    using LogicalException::LogicalException;
};
 
class InvalidArgumentException : public LogicalException
{
public:
    using LogicalException::LogicalException;
};
 
class OutOfRangeException : public LogicalException
{
public:
    using LogicalException::LogicalException;
};
 
template<typename T>
concept CPhotonException = 
    std::is_base_of_v<RuntimeException, T> ||
    std::is_base_of_v<LogicalException, T>;
 
template<CPhotonException ExceptionType, typename... Args>
[[noreturn]]
inline void throw_formatted(const std::format_string<Args...> msgFormat, Args&&... args)
{
    // Intentionally not forwarding to `std::make_format_args` due to P2905R2
    throw ExceptionType(
        std::vformat(msgFormat.get(), std::make_format_args(args...)));
}
 
}// end namespace ph