Struct bevy_internal::ecs::prelude::QueryBuilder
source · pub struct QueryBuilder<'w, D = (), F = ()>where
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, F> QueryBuilder<'w, D, F>where
D: QueryData,
F: QueryFilter,
impl<'w, D, F> QueryBuilder<'w, D, F>where
D: QueryData,
F: QueryFilter,
sourcepub fn new(world: &'w mut World) -> QueryBuilder<'w, D, F>
pub fn new(world: &'w mut World) -> QueryBuilder<'w, D, F>
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 data<T>(&mut self) -> &mut QueryBuilder<'w, D, F>where
T: QueryData,
pub fn data<T>(&mut self) -> &mut QueryBuilder<'w, D, F>where
T: QueryData,
Adds accesses required for T
to self.
sourcepub fn filter<T>(&mut self) -> &mut QueryBuilder<'w, D, F>where
T: QueryFilter,
pub fn filter<T>(&mut self) -> &mut QueryBuilder<'w, D, F>where
T: QueryFilter,
Adds filter from T
to self.
sourcepub fn with<T>(&mut self) -> &mut QueryBuilder<'w, D, F>where
T: Component,
pub fn with<T>(&mut self) -> &mut QueryBuilder<'w, D, F>where
T: Component,
Adds With<T>
to the FilteredAccess
of self.
sourcepub fn with_id(&mut self, id: ComponentId) -> &mut QueryBuilder<'w, D, F>
pub fn with_id(&mut self, id: ComponentId) -> &mut QueryBuilder<'w, D, F>
Adds With<T>
to the FilteredAccess
of self from a runtime ComponentId
.
sourcepub fn without<T>(&mut self) -> &mut QueryBuilder<'w, D, F>where
T: Component,
pub fn without<T>(&mut self) -> &mut QueryBuilder<'w, D, F>where
T: Component,
Adds Without<T>
to the FilteredAccess
of self.
sourcepub fn without_id(&mut self, id: ComponentId) -> &mut QueryBuilder<'w, D, F>
pub fn without_id(&mut self, id: ComponentId) -> &mut QueryBuilder<'w, D, F>
Adds Without<T>
to the FilteredAccess
of self from a runtime ComponentId
.
sourcepub fn ref_id(&mut self, id: ComponentId) -> &mut QueryBuilder<'w, D, F>
pub fn ref_id(&mut self, id: ComponentId) -> &mut QueryBuilder<'w, D, F>
Adds &T
to the FilteredAccess
of self.
sourcepub fn mut_id(&mut self, id: ComponentId) -> &mut QueryBuilder<'w, D, F>
pub fn mut_id(&mut self, id: ComponentId) -> &mut QueryBuilder<'w, D, F>
Adds &mut T
to the FilteredAccess
of self.
sourcepub fn optional(
&mut self,
f: impl Fn(&mut QueryBuilder<'_>)
) -> &mut QueryBuilder<'w, D, F>
pub fn optional( &mut self, f: impl Fn(&mut QueryBuilder<'_>) ) -> &mut QueryBuilder<'w, D, F>
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 QueryBuilder<'w, D, F>
pub fn and( &mut self, f: impl Fn(&mut QueryBuilder<'_>) ) -> &mut QueryBuilder<'w, D, F>
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 QueryBuilder<'w, D, F>
pub fn or( &mut self, f: impl Fn(&mut QueryBuilder<'_>) ) -> &mut QueryBuilder<'w, D, F>
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 the FilteredAccess
that will be provided to the built Query
.
sourcepub fn transmute<NewD>(&mut self) -> &mut QueryBuilder<'w, NewD>where
NewD: QueryData,
pub fn transmute<NewD>(&mut self) -> &mut QueryBuilder<'w, NewD>where
NewD: QueryData,
Transmute the existing builder adding required accesses. This will maintain all exisiting accesses.
If including a filter type see Self::transmute_filtered
sourcepub fn transmute_filtered<NewD, NewF>(
&mut self
) -> &mut QueryBuilder<'w, NewD, NewF>where
NewD: QueryData,
NewF: QueryFilter,
pub fn transmute_filtered<NewD, NewF>(
&mut self
) -> &mut QueryBuilder<'w, NewD, NewF>where
NewD: QueryData,
NewF: QueryFilter,
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, F> From<QueryBuilder<'_, D, F>> for QueryState<D, F>where
D: QueryData,
F: QueryFilter,
impl<D, F> From<QueryBuilder<'_, D, F>> for QueryState<D, F>where
D: QueryData,
F: QueryFilter,
source§fn from(value: QueryBuilder<'_, D, F>) -> QueryState<D, F>
fn from(value: QueryBuilder<'_, D, F>) -> QueryState<D, F>
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.