Struct slots::RawSlots

pub struct RawSlots<IT, N> where
    N: ArrayLength<Entry<IT>> + Unsigned,  { /* fields omitted */ }

An unchecked slab allocator with predetermined size

The allocator deals out usize handles that can be used to access the data later through a (shared or mutable) reference to the RawSlots. All access is fallible, as the handles can be arbitrarily created.

It is up to slots' users to ensure that the item they intend to access is still identified by that handle, especially as it can have been removed in the meantime, and the handle replaced by a different object.

Methods

impl<IT, N> RawSlots<IT, N> where
    N: ArrayLength<Entry<IT>> + Unsigned, 

pub fn new() -> Self

Create an empty raw slot allocator of size N.

pub fn capacity(&self) -> usize

pub fn count(&self) -> usize

pub fn store(&mut self, item: IT) -> Result<usize, IT>

Put an item into a free slot

This returns an access index for the stored data in the success case, or hands the unstored item back in case of an error.

pub fn take(&mut self, index: usize) -> Option<IT>

Move an item out of a slot, if it exists

pub fn read<T, F>(&self, index: usize, function: F) -> Option<T> where
    F: FnOnce(&IT) -> T, 

Provide immutable access to an item

The callback is only run if the given index is currently valid.

pub fn modify<T, F>(&mut self, index: usize, function: F) -> Option<T> where
    F: FnOnce(&mut IT) -> T, 

Provide mutable access to an item The callback is only run if the given index is currently valid.