Struct oxygengine_core::ecs::join::MaybeJoin

pub struct MaybeJoin<J>(pub J)
 where
    J: Join;

A Join-able structure that yields all indices, returning None for all missing elements and Some(T) for found elements.

For usage see Join::maybe().

WARNING: Do not have a join of only MaybeJoins. Otherwise the join will iterate over every single index of the bitset. If you want a join with all MaybeJoins, add an EntitiesRes to the join as well to bound the join to all entities that are alive.

Trait Implementations

impl<T> Join for MaybeJoin<T> where
    T: Join, 

type Type = Option<<T as Join>::Type>

Type of joined components.

type Value = (<T as Join>::Mask, <T as Join>::Value)

Type of joined storages.

type Mask = BitSetAll

Type of joined bit mask.

unsafe fn open(
    self
) -> (<MaybeJoin<T> as Join>::Mask, <MaybeJoin<T> as Join>::Value)

Open this join by returning the mask and the storages.

unsafe fn get(
    &mut <MaybeJoin<T> as Join>::Value,
    id: u32
) -> <MaybeJoin<T> as Join>::Type

Get a joined component value by a given index.

fn is_unconstrained() -> bool

If this Join typically returns all indices in the mask, then iterating over only it or combined with other joins that are also dangerous will cause the JoinIter/ParJoin to go through all indices which is usually not what is wanted and will kill performance.

Important traits for JoinIter<J>

impl<J> Iterator for JoinIter<J> where
    J: Join,  type Item = <J as Join>::Type;

fn join(self) -> JoinIter<Self>

Create a joined iterator over the contents.

fn maybe(self) -> MaybeJoin<Self>

Returns a Join-able structure that yields all indices, returning None for all missing elements and Some(T) for found elements.