Struct bevy_ecs::query::QueryBuilder
source · pub struct QueryBuilder<'w, D: QueryData = (), F: QueryFilter = ()> { /* private fields */ }
Expand description
Builder struct to create QueryState
instances at runtime.
let mut world = World::new();
let entity_a = world.spawn((A, B)).id();
let entity_b = world.spawn((A, C)).id();
// Instantiate the builder using the type signature of the iterator you will consume
let mut query = QueryBuilder::<(Entity, &B)>::new(&mut world)
// Add additional terms through builder methods
.with::<A>()
.without::<C>()
.build();
// Consume the QueryState
let (entity, b) = query.single(&world);
Implementations§
source§impl<'w, D: QueryData, F: QueryFilter> QueryBuilder<'w, D, F>
impl<'w, D: QueryData, F: QueryFilter> QueryBuilder<'w, D, F>
sourcepub fn new(world: &'w mut World) -> Self
pub fn new(world: &'w mut World) -> Self
Creates a new builder with the accesses required for Q
and F
sourcepub fn world_mut(&mut self) -> &mut World
pub fn world_mut(&mut self) -> &mut World
Returns a mutable reference to the world passed to Self::new
.
sourcepub fn extend_access(&mut self, access: FilteredAccess<ComponentId>)
pub fn extend_access(&mut self, access: FilteredAccess<ComponentId>)
Adds access to self’s underlying FilteredAccess
respecting Self::or
and Self::and
sourcepub fn filter<T: QueryFilter>(&mut self) -> &mut Self
pub fn filter<T: QueryFilter>(&mut self) -> &mut Self
Adds filter from T
to self.
sourcepub fn with_id(&mut self, id: ComponentId) -> &mut Self
pub fn with_id(&mut self, id: ComponentId) -> &mut Self
Adds With<T>
to the FilteredAccess
of self from a runtime ComponentId
.
sourcepub fn without<T: Component>(&mut self) -> &mut Self
pub fn without<T: Component>(&mut self) -> &mut Self
Adds Without<T>
to the FilteredAccess
of self.
sourcepub fn without_id(&mut self, id: ComponentId) -> &mut Self
pub fn without_id(&mut self, id: ComponentId) -> &mut Self
Adds Without<T>
to the FilteredAccess
of self from a runtime ComponentId
.
sourcepub fn ref_id(&mut self, id: ComponentId) -> &mut Self
pub fn ref_id(&mut self, id: ComponentId) -> &mut Self
Adds &T
to the FilteredAccess
of self.
sourcepub fn mut_id(&mut self, id: ComponentId) -> &mut Self
pub fn mut_id(&mut self, id: ComponentId) -> &mut Self
Adds &mut T
to the FilteredAccess
of self.
sourcepub fn optional(&mut self, f: impl Fn(&mut QueryBuilder<'_>)) -> &mut Self
pub fn optional(&mut self, f: impl Fn(&mut QueryBuilder<'_>)) -> &mut Self
Takes a function over mutable access to a QueryBuilder
, calls that function
on an empty builder and then adds all accesses from that builder to self as optional.
sourcepub fn and(&mut self, f: impl Fn(&mut QueryBuilder<'_>)) -> &mut Self
pub fn and(&mut self, f: impl Fn(&mut QueryBuilder<'_>)) -> &mut Self
Takes a function over mutable access to a QueryBuilder
, calls that function
on an empty builder and then adds all accesses from that builder to self.
Primarily used when inside a Self::or
closure to group several terms.
sourcepub fn or(&mut self, f: impl Fn(&mut QueryBuilder<'_>)) -> &mut Self
pub fn or(&mut self, f: impl Fn(&mut QueryBuilder<'_>)) -> &mut Self
Takes a function over mutable access to a QueryBuilder
, calls that function
on an empty builder, all accesses added to that builder will become terms in an or expression.
QueryBuilder::<Entity>::new(&mut world).or(|builder| {
builder.with::<A>();
builder.with::<B>();
});
// is equivalent to
QueryBuilder::<Entity>::new(&mut world).filter::<Or<(With<A>, With<B>)>>();
sourcepub fn access(&self) -> &FilteredAccess<ComponentId>
pub fn access(&self) -> &FilteredAccess<ComponentId>
Returns a reference to the FilteredAccess
that will be provided to the built Query
.
sourcepub fn transmute<NewD: QueryData>(&mut self) -> &mut QueryBuilder<'w, NewD>
pub fn transmute<NewD: QueryData>(&mut self) -> &mut QueryBuilder<'w, NewD>
Transmute the existing builder adding required accesses. This will maintain all existing accesses.
If including a filter type see Self::transmute_filtered
sourcepub fn transmute_filtered<NewD: QueryData, NewF: QueryFilter>(
&mut self
) -> &mut QueryBuilder<'w, NewD, NewF>
pub fn transmute_filtered<NewD: QueryData, NewF: QueryFilter>( &mut self ) -> &mut QueryBuilder<'w, NewD, NewF>
Transmute the existing builder adding required accesses. This will maintain all existing accesses.
sourcepub fn build(&mut self) -> QueryState<D, F>
pub fn build(&mut self) -> QueryState<D, F>
Create a QueryState
with the accesses of the builder.
Takes &mut self
to access the innner world reference while initializing
state for the new QueryState
Trait Implementations§
source§impl<D: QueryData, F: QueryFilter> From<QueryBuilder<'_, D, F>> for QueryState<D, F>
impl<D: QueryData, F: QueryFilter> From<QueryBuilder<'_, D, F>> for QueryState<D, F>
source§fn from(value: QueryBuilder<'_, D, F>) -> Self
fn from(value: QueryBuilder<'_, D, F>) -> Self
Auto Trait Implementations§
impl<'w, D, F> Freeze for QueryBuilder<'w, D, F>
impl<'w, D = (), F = ()> !RefUnwindSafe for QueryBuilder<'w, D, F>
impl<'w, D, F> Send for QueryBuilder<'w, D, F>
impl<'w, D, F> Sync for QueryBuilder<'w, D, F>
impl<'w, D, F> Unpin for QueryBuilder<'w, D, F>
impl<'w, D = (), F = ()> !UnwindSafe for QueryBuilder<'w, D, F>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.