helios::details Namespace Reference

Classes
struct	FreeFunctionTraits
	Traits for free function pointers. More...
struct	FreeFunctionTraits< R(*)(Args...)>
struct	MemberFunctionTraits
	Traits for member function pointers (non-const and const). More...
struct	MemberFunctionTraits< R(C::*)(Args...) const >
struct	MemberFunctionTraits< R(C::*)(Args...)>
struct	TupleToFunctionSignature
struct	TupleToFunctionSignature< std::tuple< R, Args... > >

Concepts
concept	PolymorphicConvertible
	Concept to allow argument conversion with polymorphic relationships.
concept	ClockTrait
	Concept for clock types compatible with std::chrono clocks.
concept	DurationTrait
	Concept for duration types based on std::chrono::duration.

Typedefs
template<typename Rep , typename Period >
using	NormalizedDuration = std::chrono::duration< Rep, Period >
	Helper alias to normalize a duration to its canonical std::chrono::duration form.
template<typename Clock , typename Rep , typename Period >
using	NormalizedClockDuration = std::chrono::duration< Rep, Period >
	Helper alias to normalize a clock's duration to a specific rep/period.

Functions
void	LogAssertionFailureViaLogger (std::string_view condition, const std::source_location &loc, std::string_view message) noexcept
	Bridge to logger-provided assertion logging.
void	LogAssertionFailure (std::string_view condition, const std::source_location &loc, std::string_view message) noexcept
	Unified assertion logging function used by macros below.
void	AssertionFailed (std::string_view condition, const std::source_location &loc, std::string_view message) noexcept
	Assertion handler that logs via the logger system.

Variables
constexpr bool	kEnableAssert = false

Typedef Documentation

NormalizedClockDuration

template<typename Clock , typename Rep , typename Period >

using helios::details::NormalizedClockDuration = typedef std::chrono::duration<Rep, Period>

Helper alias to normalize a clock's duration to a specific rep/period.

Definition at line 45 of file timer.hpp.

NormalizedDuration

template<typename Rep , typename Period >

using helios::details::NormalizedDuration = typedef std::chrono::duration<Rep, Period>

Helper alias to normalize a duration to its canonical std::chrono::duration form.

Definition at line 39 of file timer.hpp.

Function Documentation

AssertionFailed()

void helios::details::AssertionFailed ( std::string_view  condition, const std::source_location &  loc, std::string_view  message  )

inlinenoexcept

Assertion handler that logs via the logger system.

Parameters

condition	The failed condition as a string
loc	Source location of the assertion
message	Additional message to log

Definition at line 64 of file assert.hpp.

                                                             {
  // Log via logger (will use stderr fallback if logger is not linked)
  try {
    LogAssertionFailure(condition, loc, message);
  } catch (...) {
    // If logger fails, print to stderr as last resort
#if defined(__cpp_lib_print) && (__cpp_lib_print >= 202302L)
    if (!message.empty()) {
      std::println(stderr, "Assertion failed: {} | {} [{}:{}]", condition, message, loc.file_name(), loc.line());
    } else {
      std::println(stderr, "Assertion failed: {}\nFile: {}\nLine: {}\nFunction: {}", condition, loc.file_name(),
                   loc.line(), loc.function_name());
    }
#else
    if (!message.empty()) {
      std::fprintf(stderr, "Assertion failed: %.*s | %.*s [%s:%u]\n", static_cast<int>(condition.size()),
                   condition.data(), static_cast<int>(message.size()), message.data(), loc.file_name(), loc.line());
    } else {
      std::fprintf(stderr, "Assertion failed: %.*s\nFile: %s\nLine: %u\nFunction: %s\n",
                   static_cast<int>(condition.size()), condition.data(), loc.file_name(), loc.line(),
                   loc.function_name());
    }
#endif
  }
}

LogAssertionFailure()

void helios::details::LogAssertionFailure ( std::string_view  condition, const std::source_location &  loc, std::string_view  message  )

inlinenoexcept

Unified assertion logging function used by macros below.

Tries to forward the assertion to the logger integration function above.

If the logger isn't available (or calling it throws), this function simply returns so the caller may perform a fallback print-and-abort.

Parameters

condition	The failed condition as a string
loc	Source location of the assertion
message	Additional message to log

Definition at line 48 of file assert.hpp.

                                                                 {
  try {
    // Attempt to forward to the logger integration.
    LogAssertionFailureViaLogger(condition, loc, message);
  } catch (...) {
    // Ignore any exception and allow caller to fallback to printing.
  }
}

LogAssertionFailureViaLogger()

void helios::details::LogAssertionFailureViaLogger ( std::string_view  condition, const std::source_location &  loc, std::string_view  message  )

inlinenoexcept

Bridge to logger-provided assertion logging.

The logger implementation provides an inline function named LogAssertionFailureViaLogger in helios::details. We forward-declare it here so assert.hpp can use logger integration when available.

If the logger is present in the build, that inline function will be used. If not, calls to LogAssertionFailure below will safely fall back to printing to stderr (via std::println) and aborting.

Parameters

condition	The failed condition as a string
loc	Source location of the assertion
message	Additional message to log

Examples

/home/runner/work/HeliosEngine/HeliosEngine/src/core/include/helios/core/logger.hpp.

Definition at line 649 of file logger.hpp.

                                                                          {
  Logger::GetInstance().LogAssertionFailure(condition, loc, message);
}

Variable Documentation

kEnableAssert

constexpr bool helios::details::kEnableAssert = false

inlineconstexpr

Definition at line 94 of file assert.hpp.