Class runtime_exception

Inheritance Relationships

Base Type

Derived Types

Class Documentation

class runtime_exception : public CE::Exceptions::exception_base

Base category for an Engine operation that fails during execution, including the more specific bad_alloc, bad_request and failed_operation categories.

Constructors retain diagnostic text without throwing; their caller arguments must still be evaluated before entry.

Subclassed by CE::Exceptions::bad_alloc, CE::Exceptions::bad_request, CE::Exceptions::failed_operation

Public Functions

runtime_exception(const char *location_, uint32_t line_, const char *info_) noexcept

Capture owned category/location diagnostics, with a trace when capture/formatting succeeds.

Parameters:

  • location_ – NUL-terminated source location, normally supplied with the line by CE_HERE; null uses an unknown marker.

  • line_ – Source line number.

  • info_ – Detail copied during construction; null C strings append no detail. Embedded NUL in the string overload ends the copied detail. Trace/format/allocation failures inside the constructor use the bounded emergency summary instead of escaping. Input pointers are not retained. This does not log, throw itself, or roll back the failed operation; the caller decides whether to throw the constructed object.

inline runtime_exception(const char *location_, uint32_t line_, const std::string &info_) noexcept

Capture owned category/location diagnostics, with a trace when capture/formatting succeeds.

Parameters:

  • location_ – NUL-terminated source location, normally supplied with the line by CE_HERE; null uses an unknown marker.

  • line_ – Source line number.

  • info_ – Detail copied during construction; null C strings append no detail. Embedded NUL in the string overload ends the copied detail. Trace/format/allocation failures inside the constructor use the bounded emergency summary instead of escaping. Input pointers are not retained. This does not log, throw itself, or roll back the failed operation; the caller decides whether to throw the constructed object.

runtime_exception(const char *sub_type, const char *location_, uint32_t line_, const char *info_) noexcept

Capture owned category/location diagnostics, with a trace when capture/formatting succeeds.

Parameters:

  • location_ – NUL-terminated source location, normally supplied with the line by CE_HERE; null uses an unknown marker.

  • line_ – Source line number.

  • info_ – Detail copied during construction; null C strings append no detail. Embedded NUL in the string overload ends the copied detail.

  • sub_type – Runtime subcategory; null uses the generic runtime category. Trace/format/allocation failures inside the constructor use the bounded emergency summary instead of escaping. Input pointers are not retained. This does not log, throw itself, or roll back the failed operation; the caller decides whether to throw the constructed object.