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<'w, A: 'w + 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 + ComponentBorrow>(
    &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>(
    &'w self,
    entity: Entity
) -> Result<QueryOne<'w, Q>>

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

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

Get a single component from the world.

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

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

Get a single component from the world.

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

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

pub fn split<U: ComponentBorrow + Subset>(&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

fn has_dynamic(id: TypeId, exclusive: bool) -> bool

Returns true if id 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, A, T> From<A> for SubWorldRaw<A, T>

fn from(world: A) -> Self

Performs the conversion.

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

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

Queries the world

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

Queries the world for a specific entity

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

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

fn try_get_mut<C: Component>(&self, entity: Entity) -> Result<RefMut<'_, C>>

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

impl<'a, A: Deref<Target = World> + ExternalClone, T: ComponentBorrow, U: ComponentBorrow + Subset> TryFrom<&'_ SubWorldRaw<A, T>> for SubWorldRaw<A, U>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &SubWorldRaw<A, T>) -> Result<Self>

Performs the conversion.

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