Struct naga::arena::handlevec::HandleVec

pub(crate) struct HandleVec<T, U> {
    inner: Vec<U>,
    as_keys: PhantomData<T>,
}

A Vec indexed by Handles.

A HandleVec<T, U> is a Vec<U> indexed by values of type Handle<T>, rather than usize.

Rather than a push method, HandleVec has an insert method, analogous to HashMap::insert, that requires you to provide the handle at which the new value should appear. However, since HandleVec only supports insertion at the end, the given handle’s index must be equal to the the HandleVec’s current length; otherwise, the insertion will panic.

Fields

inner: Vec<U>

as_keys: PhantomData<T>

Implementations

impl<T, U> HandleVec<T, U>

pub(crate) const fn new() -> Self

pub(crate) fn with_capacity(capacity: usize) -> Self

pub(crate) fn len(&self) -> usize

pub(crate) fn insert(&mut self, handle: Handle<T>, value: U)

Insert a mapping from handle to value.

Unlike a HashMap, a HandleVec can only have new entries inserted at the end, like Vec::push. So the index of handle must equal self.len().

pub(crate) fn get(&self, handle: Handle<T>) -> Option<&U>

pub(crate) fn clear(&mut self)

pub(crate) fn resize(&mut self, len: usize, fill: U)

where U: Clone,

pub(crate) fn iter(&self) -> impl Iterator<Item = &U>

pub(crate) fn iter_mut(&mut self) -> impl Iterator<Item = &mut U>

Trait Implementations

impl<T: Debug, U: Debug> Debug for HandleVec<T, U>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T, U> Default for HandleVec<T, U>

fn default() -> Self

Returns the “default value” for a type.

impl<T, U> Index<Handle<T>> for HandleVec<T, U>

type Output = U

The returned type after indexing.

fn index(&self, handle: Handle<T>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T, U> IndexMut<Handle<T>> for HandleVec<T, U>

fn index_mut(&mut self, handle: Handle<T>) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<K, V> Recyclable for HandleVec<K, V>

fn recycle(self) -> Self

Clear self, retaining its current memory allocations.