Trait Storage

pub trait Storage<T>: TryDefault {
    // Required methods
    unsafe fn get(&self, index: Index) -> &T;
    unsafe fn get_mut(&mut self, index: Index) -> &mut T;
    unsafe fn insert(&mut self, index: Index, value: T);
    unsafe fn remove(&mut self, index: Index) -> T;
    unsafe fn clean<B>(&mut self, has: B)
       where B: BitSetLike;

    // Provided method
    unsafe fn drop(&mut self, index: Index) { ... }
}

Used by the framework to quickly join components.

Required Methods

unsafe fn get(&self, index: Index) -> &T

Tries reading the data associated with an Index. This is unsafe because the external set used to protect this storage is absent.

Safety

May only be called after a call to insert with id and no following call to remove with id.

A mask should keep track of those states, and an id being contained in the tracking mask is sufficient to call this method.

unsafe fn get_mut(&mut self, index: Index) -> &mut T

Tries mutating the data associated with an Index. This is unsafe because the external set used to protect this storage is absent.

Safety

May only be called after a call to insert with id and no following call to remove with id.

A mask should keep track of those states, and an id being contained in the tracking mask is sufficient to call this method.

unsafe fn insert(&mut self, index: Index, value: T)

Inserts new data for a given Index.

Safety

May only be called if insert was not called with id before, or was reverted by a call to remove with `id.

A mask should keep track of those states, and an id missing from the mask is sufficient to call insert.

unsafe fn remove(&mut self, index: Index) -> T

Removes the data associated with an Index.

Safety

May only be called if an element with id was inserted and not yet removed / dropped.

unsafe fn clean<B>(&mut self, has: B)

where B: BitSetLike,

Clean the storage given a bitset with bits set for valid indices. Allows us to safely drop the storage.

Safety

May only be called with the mask which keeps track of the elements existing in this storage.

Provided Methods

unsafe fn drop(&mut self, index: Index)

Drops the data associated with an Index. This could be used when a more efficient implementation for it exists than remove when the data is no longer needed. Defaults to simply calling remove.

Safety

May only be called if an element with id was inserted and not yet removed / dropped.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl<T> Storage<T> for BTreeStorage<T>

impl<T> Storage<T> for DenseVecStorage<T>

impl<T> Storage<T> for HashMapStorage<T>

impl<T> Storage<T> for VecStorage<T>