helios::ecs::details::QueryCacheStats Struct Reference

Statistics for query cache performance. More...

#include <query_cache.hpp>

Public Member Functions
	QueryCacheStats () noexcept=default
	QueryCacheStats (const QueryCacheStats &other)
	QueryCacheStats (QueryCacheStats &&other) noexcept
	~QueryCacheStats () noexcept=default
QueryCacheStats &	operator= (const QueryCacheStats &other)
QueryCacheStats &	operator= (QueryCacheStats &&other) noexcept
void	Reset () noexcept
double	HitRate () const noexcept

Public Attributes
std::atomic< size_t >	hit_count {0}
	Number of cache hits.
std::atomic< size_t >	miss_count {0}
	Number of cache misses.
std::atomic< size_t >	invalidation_count {0}
	Number of cache invalidations.
std::atomic< size_t >	total_queries {0}
	Total number of queries executed.
std::atomic< size_t >	archetype_changes {0}
	Number of archetype structural changes.
std::atomic< size_t >	partial_invalidations {0}
	Number of partial (component-specific) invalidations.

Detailed Description

Statistics for query cache performance.

Tracks cache effectiveness metrics including hits, misses, and invalidations.

Note

Thread-safe.

Definition at line 104 of file query_cache.hpp.

Constructor & Destructor Documentation

QueryCacheStats() [1/3]

helios::ecs::details::QueryCacheStats::QueryCacheStats ( )

defaultnoexcept

QueryCacheStats() [2/3]

helios::ecs::details::QueryCacheStats::QueryCacheStats ( const QueryCacheStats &  other )

inline

Definition at line 125 of file query_cache.hpp.

    : hit_count(other.hit_count.load(std::memory_order_relaxed)),
      miss_count(other.miss_count.load(std::memory_order_relaxed)),
      invalidation_count(other.invalidation_count.load(std::memory_order_relaxed)),
      total_queries(other.total_queries.load(std::memory_order_relaxed)),
      archetype_changes(other.archetype_changes.load(std::memory_order_relaxed)),
      partial_invalidations(other.partial_invalidations.load(std::memory_order_relaxed)) {}

QueryCacheStats() [3/3]

helios::ecs::details::QueryCacheStats::QueryCacheStats ( QueryCacheStats &&  other )

inlinenoexcept

Definition at line 133 of file query_cache.hpp.

    : hit_count(other.hit_count.load(std::memory_order_relaxed)),
      miss_count(other.miss_count.load(std::memory_order_relaxed)),
      invalidation_count(other.invalidation_count.load(std::memory_order_relaxed)),
      total_queries(other.total_queries.load(std::memory_order_relaxed)),
      archetype_changes(other.archetype_changes.load(std::memory_order_relaxed)),
      partial_invalidations(other.partial_invalidations.load(std::memory_order_relaxed)) {}

~QueryCacheStats()

helios::ecs::details::QueryCacheStats::~QueryCacheStats ( )

defaultnoexcept

Member Function Documentation

HitRate()

double helios::ecs::details::QueryCacheStats::HitRate ( ) const

inlinenoexcept

Definition at line 180 of file query_cache.hpp.

                                                      {
  const size_t total = total_queries.load(std::memory_order_relaxed);
  if (total == 0) [[unlikely]] {
    return 0.0;
  }
 
  const size_t hits = hit_count.load(std::memory_order_relaxed);
  return static_cast<double>(hits) / static_cast<double>(total);
}

operator=() [1/2]

QueryCacheStats & helios::ecs::details::QueryCacheStats::operator= ( const QueryCacheStats &  other )

inline

Definition at line 141 of file query_cache.hpp.

                                                                               {
  if (this == &other) [[unlikely]] {
    return *this;
  }
 
  hit_count.store(other.hit_count.load(std::memory_order_relaxed), std::memory_order_relaxed);
  miss_count.store(other.miss_count.load(std::memory_order_relaxed), std::memory_order_relaxed);
  invalidation_count.store(other.invalidation_count.load(std::memory_order_relaxed), std::memory_order_relaxed);
  total_queries.store(other.total_queries.load(std::memory_order_relaxed), std::memory_order_relaxed);
  archetype_changes.store(other.archetype_changes.load(std::memory_order_relaxed), std::memory_order_relaxed);
  partial_invalidations.store(other.partial_invalidations.load(std::memory_order_relaxed), std::memory_order_relaxed);
 
  return *this;
}

operator=() [2/2]

QueryCacheStats & helios::ecs::details::QueryCacheStats::operator= ( QueryCacheStats &&  other )

inlinenoexcept

Definition at line 156 of file query_cache.hpp.

                                                                                   {
  if (this == &other) [[unlikely]] {
    return *this;
  }
 
  hit_count.store(other.hit_count.load(std::memory_order_relaxed), std::memory_order_relaxed);
  miss_count.store(other.miss_count.load(std::memory_order_relaxed), std::memory_order_relaxed);
  invalidation_count.store(other.invalidation_count.load(std::memory_order_relaxed), std::memory_order_relaxed);
  total_queries.store(other.total_queries.load(std::memory_order_relaxed), std::memory_order_relaxed);
  archetype_changes.store(other.archetype_changes.load(std::memory_order_relaxed), std::memory_order_relaxed);
  partial_invalidations.store(other.partial_invalidations.load(std::memory_order_relaxed), std::memory_order_relaxed);
 
  return *this;
}

Reset()

void helios::ecs::details::QueryCacheStats::Reset ( )

inlinenoexcept

Definition at line 171 of file query_cache.hpp.

                                            {
  hit_count.store(0, std::memory_order_relaxed);
  miss_count.store(0, std::memory_order_relaxed);
  invalidation_count.store(0, std::memory_order_relaxed);
  total_queries.store(0, std::memory_order_relaxed);
  archetype_changes.store(0, std::memory_order_relaxed);
  partial_invalidations.store(0, std::memory_order_relaxed);
}

Member Data Documentation

archetype_changes

std::atomic<size_t> helios::ecs::details::QueryCacheStats::archetype_changes {0}

Number of archetype structural changes.

Definition at line 109 of file query_cache.hpp.

{0};      ///< Number of archetype structural changes

hit_count

std::atomic<size_t> helios::ecs::details::QueryCacheStats::hit_count {0}

Number of cache hits.

Definition at line 105 of file query_cache.hpp.

{0};              ///< Number of cache hits

invalidation_count

std::atomic<size_t> helios::ecs::details::QueryCacheStats::invalidation_count {0}

Number of cache invalidations.

Definition at line 107 of file query_cache.hpp.

{0};     ///< Number of cache invalidations

miss_count

std::atomic<size_t> helios::ecs::details::QueryCacheStats::miss_count {0}

Number of cache misses.

Definition at line 106 of file query_cache.hpp.

{0};             ///< Number of cache misses

partial_invalidations

std::atomic<size_t> helios::ecs::details::QueryCacheStats::partial_invalidations {0}

Number of partial (component-specific) invalidations.

Definition at line 110 of file query_cache.hpp.

{0};  ///< Number of partial (component-specific) invalidations

total_queries

std::atomic<size_t> helios::ecs::details::QueryCacheStats::total_queries {0}

Total number of queries executed.

Definition at line 108 of file query_cache.hpp.

{0};          ///< Total number of queries executed