Struct SimpleQueryCache 

pub struct SimpleQueryCache { /* private fields */ }

Cached query for SimpleWorld that avoids re-scanning when the world hasn’t changed.

Tracks a single component type and caches matching entity IDs. Automatically invalidates when the world version changes.

Example

use cougr_core::query::SimpleQueryCache;
use cougr_core::simple_world::SimpleWorld;
use soroban_sdk::{symbol_short, Bytes, Env};

let env = Env::default();
let mut world = SimpleWorld::new(&env);
let entity = world.spawn_entity();
world.add_component(entity, symbol_short!("position"), Bytes::new(&env));

let mut cache = SimpleQueryCache::new(symbol_short!("position"), &env);
let entities = cache.execute(&world, &env);
assert_eq!(entities.len(), 1);
let entities2 = cache.execute(&world, &env);
assert_eq!(entities2.len(), 1);

Implementations

impl SimpleQueryCache

pub fn new(component_type: Symbol, env: &Env) -> Self

Create a new query cache for a specific component type

pub fn from_query(query: SimpleQuery, env: &Env) -> Self

Create a cache from an explicit SimpleQuery.

pub fn execute( &mut self, world: &SimpleWorld, env: &Env, ) -> &Vec<SimpleEntityId>

Execute the query, returning cached results if the world hasn’t changed.

pub fn invalidate(&mut self)

Force invalidation of the cache.

pub fn is_valid(&self, world_version: u64) -> bool

Check if the cache is up-to-date with the given world version.

pub fn query(&self) -> &SimpleQuery

Returns the underlying query.