Struct zone_alloc::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 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_mut(&mut self) -> IterMut<'_, T>

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

Registries only allow mutable iteration because the entire registry must be borrowed for the duration of the iteration. The mutable borrow to call this method allows Rust’s borrow checker to enforce this rule.

pub fn get_mut(&self, handle: H) -> Option<&mut T>

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

pub fn get(&self, handle: H) -> Option<&T>

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