Trait toad_array::Array

pub trait Array: Default + Len + Reserve + Filled<Self::Item> + Trunc + Indexed<Self::Item> + Extend<Self::Item> + FromIterator<Self::Item> + IntoIterator<Item = Self::Item> {
    type Item;
}

An ordered indexable collection of some type Item

Provided implementations

• Vec
• tinyvec::ArrayVec

Notably, not heapless::ArrayVec or arrayvec::ArrayVec. An important usecase within toad is Extending the collection, and the performance of heapless and arrayvec’s Extend implementations are notably worse than tinyvec.

tinyvec also has the added bonus of being 100% unsafe-code-free, meaning if you choose tinyvec you eliminate the possibility of memory defects and UB.

Requirements

• Default for creating the collection
• Extend for mutating and adding onto the collection (1 or more elements)
• Reserve for reserving space ahead of time
• [GetSize] for bound checks, empty checks, and accessing the length
• FromIterator for collecting into the collection
• IntoIterator for iterating and destroying the collection
• Deref<Target = [T]> and DerefMut for:
  • indexing (Index, IndexMut)
  • iterating (&[T].iter() and &mut [T].iter_mut())

Required Associated Types

type Item

The type of item contained in the collection

Implementations on Foreign Types

impl<A: Array<Item = T>, T> Array for ArrayVec<A>where Self: Filled<T> + Trunc,

type Item = T

impl<T> Array for Vec<T>

type Item = T

Implementors