Struct SimpleQuery 

pub struct SimpleQuery { /* private fields */ }

Query builder and executable query for SimpleWorld.

SimpleQuery is the preferred query surface for Soroban gameplay loops: it supports required, excluded, and optional-match components while selecting the narrowest indexed candidate set available.

Implementations

impl SimpleQuery

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

Create an empty query over table-backed components.

pub fn with_component(self, component_type: Symbol) -> Self

Require the entity to have this component.

pub fn with_components(self, component_types: &[Symbol]) -> Self

Require the entity to have all components from this slice.

pub fn without_component(self, component_type: Symbol) -> Self

Exclude entities with this component.

pub fn without_components(self, component_types: &[Symbol]) -> Self

Exclude entities that have any component from this slice.

pub fn with_any_component(self, component_type: Symbol) -> Self

Require the entity to match at least one component from this set.

pub fn with_any_components(self, component_types: &[Symbol]) -> Self

Require the entity to match at least one component from this slice.

pub fn include_sparse(self) -> Self

Include both table and sparse storage during execution.

pub fn is_empty(&self) -> bool

Returns whether the query has no constraints.

pub fn storage(&self) -> QueryStorage

Returns the current storage mode for the query.

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

Execute the query against a SimpleWorld.

pub fn candidate_count(&self, world: &SimpleWorld, env: &Env) -> usize

Returns the number of entities that must be scanned before final filtering.

Trait Implementations

impl Clone for SimpleQuery

fn clone(&self) -> SimpleQuery

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SimpleQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.