Struct specs_static::Storage

pub struct Storage<C, D: UnprotectedStorage<C>, I> { /* fields omitted */ }

A storage for components managed with specs_static::Id instead of Entity. This Storage behaves very similar to specs' Storage.

Registering

These component storages also have to be registered. This can be done using the WorldExt trait and its register_tile_comp method.

Methods

impl<C, D, I> Storage<C, D, I> where
    C: Component,
    D: UnprotectedStorage<C>,
    I: Id, 

pub fn get(&self, id: I) -> Option<&C>

Tries to retrieve a component by its Id. This will only check whether a component is inserted or not, without doing any liveness checks for the id.

pub fn get_mut(&mut self, id: I) -> Option<&mut C>

Tries to retrieve a component mutably by its Id. This will only check whether a component is inserted or not, without doing any liveness checks for the id.

pub fn insert(&mut self, id: I, comp: C) -> Option<C>

Inserts comp at id. If there already was a value, it will be returned.

In contrast to entities, there are no invalid ids.

pub fn remove(&mut self, id: I) -> Option<C>

Removes the component at id.

Trait Implementations

impl<C, D, I> Drop for Storage<C, D, I> where
    D: UnprotectedStorage<C>, 

fn drop(&mut self)

Executes the destructor for this type.

impl<C, D: UnprotectedStorage<C>, I> Default for Storage<C, D, I> where
    D: Default, 

fn default() -> Self

Returns the "default value" for a type.

impl<'a, C, D, I> Join for &'a Storage<C, D, I> where
    D: UnprotectedStorage<C>, 

type Type = &'a C

Type of joined components.

type Value = &'a D

Type of joined storages.

type Mask = &'a BitSet

Type of joined bit mask.

unsafe fn open(self) -> (Self::Mask, Self::Value)

Open this join by returning the mask and the storages.

unsafe fn get(value: &mut Self::Value, id: u32) -> Self::Type

Get a joined component value by a given index.

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.

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.

impl<'a, C, D, I> Join for &'a mut Storage<C, D, I> where
    D: UnprotectedStorage<C>, 

type Type = &'a mut C

Type of joined components.

type Value = &'a mut D

Type of joined storages.

type Mask = &'a BitSet

Type of joined bit mask.

unsafe fn open(self) -> (Self::Mask, Self::Value)

Open this join by returning the mask and the storages.

unsafe fn get(value: &mut Self::Value, id: u32) -> Self::Type

Get a joined component value by a given index.

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.

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.

impl<C, D, I> Tracked for Storage<C, D, I> where
    D: Tracked + UnprotectedStorage<C>,
    C: Component, 

fn channel(&self) -> &EventChannel<ComponentEvent>

Event channel tracking modified/inserted/removed components.

fn channel_mut(&mut self) -> &mut EventChannel<ComponentEvent>

Mutable event channel tracking modified/inserted/removed components.