Struct StrongRegistry

pub struct StrongRegistry<H, T> { /* private fields */ }

The same as Registry<T>, but with strongly-typed handles to prevent handles from being shared across multiple registries.

The handle type must implement the StrongHandle trait.

Implementations

impl<H, T> StrongRegistry<H, T>

where H: StrongHandle,

pub fn new() -> Self

Creates a new strong registry.

pub fn with_capacity(size: usize) -> Self

Creates a new strong registry with the given capacity.

pub fn is_empty(&self) -> bool

Checks if the registry is empty.

pub fn len(&self) -> usize

Returns the number of elements owned by the strong registry.

pub fn register(&self, value: T) -> H

Registers a new value in the arena, returning a handle to that value.

pub fn register_extend<I>(&self, iterable: I) -> (H, H)

where I: IntoIterator<Item = T>,

Registers the contents of an iterator in the registry.

Returns a numeric range of handles [a, b), where a is the handle of the first element inserted and b is the handle after the last element inserted.

pub fn reserve(&self, additional: usize)

Ensures there is enough continuous space for at least additional values.

pub fn into_vec(self) -> Vec<T>

Converts the StrongRegistry<T> into a Vec<T>.

Items will maintain their handle as their vector index.

pub fn iter( &self, ) -> impl Iterator<Item = Result<ElementRef<'_, T>, BorrowError>>

Returns an iterator that provides immutable access to all elements in the registry, in order of registration.

pub fn iter_mut( &mut self, ) -> impl Iterator<Item = Result<ElementRefMut<'_, T>, BorrowError>>

Returns an iterator that provides mutable access to all elements in the registry, in order of registration.

pub fn get_unchecked(&self, handle: H) -> ElementRef<'_, T>

Returns a reference to a value previously registered in the registry.

Panics if there is a borrow error.

pub fn get(&self, handle: H) -> Result<ElementRef<'_, T>, BorrowError>

Tries to get a reference to a value previously registered in the registry.

pub fn get_mut_unchecked(&self, handle: H) -> ElementRefMut<'_, T>

Returns a mutable reference to a value previously registered in the registry.

Panics if there is a borrow error.

pub fn get_mut(&self, handle: H) -> Result<ElementRefMut<'_, T>, BorrowError>

Tries to get a mutable reference to a value previously registered in the registry.

pub fn safe_to_drop(&mut self) -> bool

Checks if the registry is safe to drop.

A registry is safe to drop if all elements are not borrowed. This check is not thread safe.

Trait Implementations

impl<H: Default, T: Default> Default for StrongRegistry<H, T>

fn default() -> StrongRegistry<H, T>

Returns the “default value” for a type.