Struct View

Source
pub struct View<'q, Q>
where Q: Query,
{ /* private fields */ }
Expand description

Provides random access to the results of a query

Implementations§

Source§

impl<'q, Q> View<'q, Q>
where Q: Query,

Source

pub fn get(&self, entity: Entity) -> Option<<Q as Query>::Item<'_>>
where Q: QueryShared,

Retrieve the query results corresponding to entity

Will yield None if the entity does not exist or does not match the query.

Does not require exclusive access to the map, but is defined only for queries yielding only shared references.

Source

pub fn get_mut(&mut self, entity: Entity) -> Option<<Q as Query>::Item<'_>>

Retrieve the query results corresponding to entity

Will yield None if the entity does not exist or does not match the query.

Source

pub fn contains(&self, entity: Entity) -> bool

Equivalent to get(entity).is_some(), but does not require Q: QueryShared

Source

pub unsafe fn get_unchecked( &self, entity: Entity, ) -> Option<<Q as Query>::Item<'_>>

Like get_mut, but allows simultaneous access to multiple entities

§Safety

Must not be invoked while any unique borrow of the fetched components of entity is live.

Source

pub fn get_many_mut<const N: usize>( &mut self, entities: [Entity; N], ) -> [Option<<Q as Query>::Item<'_>>; N]

Like get_mut, but allows checked simultaneous access to multiple entities

For N > 3, the check for distinct entities will clone the array and take O(N log N) time.

§Examples
let mut world = World::new();

let a = world.spawn((1, 1.0));
let b = world.spawn((2, 4.0));
let c = world.spawn((3, 9.0));

let mut query = world.query_mut::<&mut i32>();
let mut view = query.view();
let [a,b,c] = view.get_mut_n([a, b, c]);

assert_eq!(*a.unwrap(), 1);
assert_eq!(*b.unwrap(), 2);
assert_eq!(*c.unwrap(), 3);
Source

pub fn iter_mut(&mut self) -> ViewIter<'_, Q>

Iterate over all entities satisfying Q

Equivalent to QueryBorrow::iter.

Trait Implementations§

Source§

impl<'a, 'q, Q> IntoIterator for &'a mut View<'q, Q>
where Q: Query,

Source§

type IntoIter = ViewIter<'a, Q>

Which kind of iterator are we turning this into?
Source§

type Item = (Entity, <Q as Query>::Item<'a>)

The type of the elements being iterated over.
Source§

fn into_iter(self) -> <&'a mut View<'q, Q> as IntoIterator>::IntoIter

Creates an iterator from a value. Read more
Source§

impl<'q, Q> Send for View<'q, Q>
where Q: Query, <Q as Query>::Item<'a>: for<'a> Send,

Source§

impl<'q, Q> Sync for View<'q, Q>
where Q: Query, <Q as Query>::Item<'a>: for<'a> Send,

Auto Trait Implementations§

§

impl<'q, Q> Freeze for View<'q, Q>

§

impl<'q, Q> RefUnwindSafe for View<'q, Q>
where <Q as Query>::Fetch: RefUnwindSafe,

§

impl<'q, Q> Unpin for View<'q, Q>
where <Q as Query>::Fetch: Unpin,

§

impl<'q, Q> UnwindSafe for View<'q, Q>
where <Q as Query>::Fetch: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> Finalize for T

Source§

unsafe fn finalize_raw(data: *mut ())

Safety Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Component for T
where T: Send + Sync + 'static,