Struct Storage

pub struct Storage<'a, BackingTy> { /* private fields */ }

A wrapper over the innards of a FlatVec which exposes mutating operations which cannot corrupt other elements when inserting a new element.

Implementations

impl<BackingTy> Storage<'_, BackingTy>

where BackingTy: Default,

pub fn allocate(&mut self, requested: usize) -> &mut [BackingTy]

Returns a Default slice of BackingTy that will be considered part of this flattened object.

Note that even if you do not use part of this slice, the whole slice will be presented to a FromFlat implementation. This function may be called multiple times in a single IntoFlat implementation or combined with Storage::extend if a flattened object is complex, but it is significantly more efficient to use a single Storage::allocate call where possible.

pub fn reserve(&mut self, requested: usize)

Reserves capacity for at least len additional BackingTy.

pub fn extend<Iter>(&mut self, iter: Iter)

where Iter: IntoIterator<Item = BackingTy>,

Inserts the BackingTy yielded by iter.

In general, this is ~2x slower than calling allocate when the exact size of the inserted object is known.