Struct hecs_schedule::SubWorldRaw

pub struct SubWorldRaw<A, T> { /* fields omitted */ }

Represents a borrow of the world which can only access a subset of components (unless AllAccess is used).

This type allows for any reference kind, such as &World, AtomicRef, Ref, etc.

Type alises are provided for the most common usages, with SubWorld being the one used by Schedule.

Implementations

impl<A, T> SubWorldRaw<A, T>

pub fn new(world: A) -> Self

Splits the world into a subworld. No borrow checking is performed so may fail during query unless guarded otherwise.

impl<A: Deref<Target = World>, T: ComponentBorrow> SubWorldRaw<A, T>

pub fn has<U: IntoAccess>(&self) -> bool

Returns true if the subworld can access the borrow of T

pub fn has_all<U: Subset>(&self) -> bool

Returns true if the world satisfies the whole query

pub fn query<Q: Query + Subset>(&self) -> QueryBorrow<'_, Q>

Query the subworld.

Panics

Panics if the query items are not a compatible subset of the subworld.

pub fn try_query<Q: Query + Subset>(&self) -> Result<QueryBorrow<'_, Q>>

Query the subworld. Fails if the query items are not compatible with the subworld

pub fn try_query_one<Q: Query + Subset>(
    &self,
    entity: Entity
) -> Result<QueryOne<'_, Q>>

Query the subworld for a single entity. Wraps the hecs::NoSuchEntity error and provides the entity id

pub fn try_get<C: Component>(&self, entity: Entity) -> Result<Ref<'_, C>>

Get a single component from the world.

If a mutable borrow is desired, use Self::query_one since the world is only immutably borrowed.

Wraps the hecs::NoSuchEntity error and provides the entity id

impl<A: Deref<Target = World> + Clone, T: ComponentBorrow> SubWorldRaw<A, T>

pub fn split<U: ComponentBorrow + Subset>(
    &mut self
) -> Result<SubWorldRaw<A, U>>

Splits the subworld further into a compatible subworld. Fails if not compatible

Trait Implementations

impl<A, T: ComponentBorrow> ComponentBorrow for SubWorldRaw<A, T>

fn borrows() -> Borrows

Returns a list of all component accesses

fn has<U: IntoAccess>() -> bool

Returns true if U exists in Self

impl<'a, T> From<&'a Context<'a>> for SubWorldRaw<AtomicRef<'a, World>, T>

fn from(context: &'a Context<'_>) -> Self

Performs the conversion.

impl<A: Deref<Target = World>, T: ComponentBorrow> GenericWorld for SubWorldRaw<A, T>

fn query<Q: Query + Subset>(&self) -> QueryBorrow<'_, Q>

Queries the world

fn query_one<Q: Query + Subset>(
    &self,
    entity: Entity
) -> Result<QueryOne<'_, Q>, NoSuchEntity>

Queries the world for a specific entity

fn get<C: Component>(
    &self,
    entity: Entity
) -> Result<Ref<'_, C>, ComponentError>

Get a single component for an entity Returns the contextual result since hecs-schedule is required to be imported anyway

impl<'a, A, T> View<'a> for SubWorldRaw<A, T> where
    A: Deref<Target = World>,
    T: ComponentBorrow, 

type Superset = A

The type which View comes from

fn split(world: Self::Superset) -> Self

Splits from the containing superset