Struct QueryBuilder 

pub struct QueryBuilder<'w, Q: WorldQuery, F: QueryFilter = ()> { /* private fields */ }

Builder for constructing and executing queries.

Created by World::query(). Chain .with::<T>() and .without::<T>() to add filters, then call .iter() or .get(id) to execute.

Implementations

impl<'w, Q: WorldQuery, F: QueryFilter> QueryBuilder<'w, Q, F>

pub const fn with<T: 'static>(self) -> QueryBuilder<'w, Q, (F, With<T>)>

where (F, With<T>): QueryFilter,

Add a With<T> filter — only match entities that have built-in component T.

pub const fn without<T: 'static>(self) -> QueryBuilder<'w, Q, (F, Without<T>)>

where (F, Without<T>): QueryFilter,

Add a Without<T> filter — exclude entities that have built-in component T.

pub const fn ext_with<T: 'static + Send + Sync>( self, ) -> QueryBuilder<'w, Q, (F, ExtWith<T>)>

where (F, ExtWith<T>): QueryFilter,

Add an ExtWith<T> filter — only match entities with extension component T.

pub const fn ext_without<T: 'static + Send + Sync>( self, ) -> QueryBuilder<'w, Q, (F, ExtWithout<T>)>

where (F, ExtWithout<T>): QueryFilter,

Add an ExtWithout<T> filter — exclude entities with extension component T.

pub fn iter(self) -> QueryIter<'w, Q, F>

Execute the query and iterate matching entities.

pub fn get(self, id: EntityId) -> Option<Q::Item<'w>>

Fetch a single entity by ID.