pub struct Storage<'e, T, D> { /* private fields */ }
Expand description
A wrapper around the masked storage and the generations vector.
Can be used for safe lookup of components, insertions and removes.
This is what World::read/write
fetches for the user.
Implementations
sourceimpl<'st, T, D> Storage<'st, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
impl<'st, T, D> Storage<'st, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
sourcepub fn restrict<'rf>(
&'rf self
) -> RestrictedStorage<'rf, 'st, T, &'_ T::Storage, &'_ BitSet, ImmutableParallelRestriction>
pub fn restrict<'rf>(
&'rf self
) -> RestrictedStorage<'rf, 'st, T, &'_ T::Storage, &'_ BitSet, ImmutableParallelRestriction>
Builds an immutable RestrictedStorage
out of a Storage
. Allows deferred
unchecked access to the entity’s component.
This is returned as a ParallelRestriction
version since you can only get
immutable components with this which is safe for parallel by default.
sourceimpl<'st, T, D> Storage<'st, T, D>where
T: Component,
D: DerefMut<Target = MaskedStorage<T>>,
impl<'st, T, D> Storage<'st, T, D>where
T: Component,
D: DerefMut<Target = MaskedStorage<T>>,
sourcepub fn restrict_mut<'rf>(
&'rf mut self
) -> RestrictedStorage<'rf, 'st, T, &'_ mut T::Storage, &'_ BitSet, SequentialRestriction>
pub fn restrict_mut<'rf>(
&'rf mut self
) -> RestrictedStorage<'rf, 'st, T, &'_ mut T::Storage, &'_ BitSet, SequentialRestriction>
Builds a mutable RestrictedStorage
out of a Storage
. Allows restricted
access to the inner components without allowing invalidating the
bitset for iteration in Join
.
sourcepub fn par_restrict_mut<'rf>(
&'rf mut self
) -> RestrictedStorage<'rf, 'st, T, &'_ mut T::Storage, &'_ BitSet, MutableParallelRestriction>
pub fn par_restrict_mut<'rf>(
&'rf mut self
) -> RestrictedStorage<'rf, 'st, T, &'_ mut T::Storage, &'_ BitSet, MutableParallelRestriction>
Builds a mutable, parallel RestrictedStorage
,
does not allow mutably getting other components
aside from the current iteration.
sourceimpl<'e, T, D> Storage<'e, T, D>where
T: Component,
T::Storage: Tracked,
D: Deref<Target = MaskedStorage<T>>,
impl<'e, T, D> Storage<'e, T, D>where
T: Component,
T::Storage: Tracked,
D: Deref<Target = MaskedStorage<T>>,
sourcepub fn channel(&self) -> &EventChannel<ComponentEvent>
pub fn channel(&self) -> &EventChannel<ComponentEvent>
Returns the event channel tracking modified components.
sourceimpl<'e, T, D> Storage<'e, T, D>where
T: Component,
T::Storage: Tracked,
D: DerefMut<Target = MaskedStorage<T>>,
impl<'e, T, D> Storage<'e, T, D>where
T: Component,
T::Storage: Tracked,
D: DerefMut<Target = MaskedStorage<T>>,
sourcepub fn channel_mut(&mut self) -> &mut EventChannel<ComponentEvent>
pub fn channel_mut(&mut self) -> &mut EventChannel<ComponentEvent>
Returns the event channel for insertions/removals/modifications of this storage’s components.
sourcepub fn register_reader(&mut self) -> ReaderId<ComponentEvent>
pub fn register_reader(&mut self) -> ReaderId<ComponentEvent>
Starts tracking component events. Note that this reader id should be used every frame, otherwise events will pile up and memory use by the event channel will grow waiting for this reader.
sourcepub fn flag(&mut self, event: ComponentEvent)
pub fn flag(&mut self, event: ComponentEvent)
Flags an index with a ComponentEvent
.
sourceimpl<'e, T, D> Storage<'e, T, D>
impl<'e, T, D> Storage<'e, T, D>
sourcepub fn new(entities: Fetch<'e, EntitiesRes>, data: D) -> Storage<'e, T, D>
pub fn new(entities: Fetch<'e, EntitiesRes>, data: D) -> Storage<'e, T, D>
Create a new Storage
sourceimpl<'e, T, D> Storage<'e, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
impl<'e, T, D> Storage<'e, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
sourceimpl<'e, T, D> Storage<'e, T, D>where
T: Component,
D: DerefMut<Target = MaskedStorage<T>>,
impl<'e, T, D> Storage<'e, T, D>where
T: Component,
D: DerefMut<Target = MaskedStorage<T>>,
sourcepub unsafe fn unprotected_storage_mut(&mut self) -> &mut T::Storage
pub unsafe fn unprotected_storage_mut(&mut self) -> &mut T::Storage
Gets mutable access to the wrapped storage.
This is unsafe because modifying the wrapped storage without also updating the mask bitset accordingly can result in illegal memory access.
sourcepub fn get_mut(&mut self, e: Entity) -> Option<&mut T>
pub fn get_mut(&mut self, e: Entity) -> Option<&mut T>
Tries to mutate the data associated with an Entity
.
sourcepub fn entry<'a>(
&'a mut self,
e: Entity
) -> Result<StorageEntry<'a, 'e, T, D>, WrongGeneration>where
'e: 'a,
pub fn entry<'a>(
&'a mut self,
e: Entity
) -> Result<StorageEntry<'a, 'e, T, D>, WrongGeneration>where
'e: 'a,
Returns an entry to the component associated to the entity.
Behaves somewhat similarly to std::collections::HashMap
’s entry api.
Example
if let Ok(entry) = storage.entry(entity) {
entry.or_insert(Comp { field: 55 });
}
sourcepub fn insert(&mut self, e: Entity, v: T) -> InsertResult<T>
pub fn insert(&mut self, e: Entity, v: T) -> InsertResult<T>
Inserts new data for a given Entity
.
Returns the result of the operation as a InsertResult<T>
If a component already existed for the given Entity
, then it will
be overwritten with the new component. If it did overwrite, then the
result will contain Some(T)
where T
is the previous component.
Trait Implementations
sourceimpl<'a, 'e, T, D> Join for &'a Storage<'e, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
impl<'a, 'e, T, D> Join for &'a Storage<'e, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
sourceunsafe fn open(self) -> (Self::Mask, Self::Value)
unsafe fn open(self) -> (Self::Mask, Self::Value)
sourceunsafe fn get(v: &mut Self::Value, i: Index) -> &'a T
unsafe fn get(v: &mut Self::Value, i: Index) -> &'a T
sourcefn join(self) -> JoinIter<Self>ⓘNotable traits for JoinIter<J>impl<J: Join> Iterator for JoinIter<J> type Item = J::Type;
where
Self: Sized,
fn join(self) -> JoinIter<Self>ⓘNotable traits for JoinIter<J>impl<J: Join> Iterator for JoinIter<J> type Item = J::Type;
where
Self: Sized,
sourcefn maybe(self) -> MaybeJoin<Self>where
Self: Sized,
fn maybe(self) -> MaybeJoin<Self>where
Self: Sized,
Join
-able structure that yields all indices, returning None
for all
missing elements and Some(T)
for found elements. Read moresourcefn is_unconstrained() -> bool
fn is_unconstrained() -> bool
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. Read moresourceimpl<'a, 'e, T, D> Join for &'a mut Storage<'e, T, D>where
T: Component,
D: DerefMut<Target = MaskedStorage<T>>,
impl<'a, 'e, T, D> Join for &'a mut Storage<'e, T, D>where
T: Component,
D: DerefMut<Target = MaskedStorage<T>>,
sourceunsafe fn open(self) -> (Self::Mask, Self::Value)
unsafe fn open(self) -> (Self::Mask, Self::Value)
sourceunsafe fn get(v: &mut Self::Value, i: Index) -> &'a mut T
unsafe fn get(v: &mut Self::Value, i: Index) -> &'a mut T
sourcefn join(self) -> JoinIter<Self>ⓘNotable traits for JoinIter<J>impl<J: Join> Iterator for JoinIter<J> type Item = J::Type;
where
Self: Sized,
fn join(self) -> JoinIter<Self>ⓘNotable traits for JoinIter<J>impl<J: Join> Iterator for JoinIter<J> type Item = J::Type;
where
Self: Sized,
sourcefn maybe(self) -> MaybeJoin<Self>where
Self: Sized,
fn maybe(self) -> MaybeJoin<Self>where
Self: Sized,
Join
-able structure that yields all indices, returning None
for all
missing elements and Some(T)
for found elements. Read moresourcefn is_unconstrained() -> bool
fn is_unconstrained() -> bool
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. Read moresourceimpl<'a, 'e, T, D> Not for &'a Storage<'e, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
impl<'a, 'e, T, D> Not for &'a Storage<'e, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
sourceimpl<'a, 'e, T, D> ParJoin for &'a Storage<'e, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
T::Storage: Sync,
impl<'a, 'e, T, D> ParJoin for &'a Storage<'e, T, D>where
T: Component,
D: Deref<Target = MaskedStorage<T>>,
T::Storage: Sync,
sourcefn par_join(self) -> JoinParIter<Self>where
Self: Sized,
fn par_join(self) -> JoinParIter<Self>where
Self: Sized,
sourceimpl<'a, 'e, T, D> ParJoin for &'a mut Storage<'e, T, D>where
T: Component,
D: DerefMut<Target = MaskedStorage<T>>,
T::Storage: Sync + DistinctStorage,
impl<'a, 'e, T, D> ParJoin for &'a mut Storage<'e, T, D>where
T: Component,
D: DerefMut<Target = MaskedStorage<T>>,
T::Storage: Sync + DistinctStorage,
sourcefn par_join(self) -> JoinParIter<Self>where
Self: Sized,
fn par_join(self) -> JoinParIter<Self>where
Self: Sized,
impl<'a, T: Component, D> DistinctStorage for Storage<'a, T, D>where
T::Storage: DistinctStorage,
Auto Trait Implementations
impl<'e, T, D> !RefUnwindSafe for Storage<'e, T, D>
impl<'e, T, D> Send for Storage<'e, T, D>where
D: Send,
T: Send,
impl<'e, T, D> Sync for Storage<'e, T, D>where
D: Sync,
T: Sync,
impl<'e, T, D> Unpin for Storage<'e, T, D>where
D: Unpin,
T: Unpin,
impl<'e, T, D> !UnwindSafe for Storage<'e, T, D>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
sourceimpl<'a, T> DynamicSystemData<'a> for Twhere
T: SystemData<'a>,
impl<'a, T> DynamicSystemData<'a> for Twhere
T: SystemData<'a>,
type Accessor = StaticAccessor<T>
type Accessor = StaticAccessor<T>
SystemData
, which specifies the read and write dependencies and does
the fetching. Read moresourcefn setup(_: &StaticAccessor<T>, res: &mut Resources)
fn setup(_: &StaticAccessor<T>, res: &mut Resources)
Resources
for fetching this system data.