Trait Storage 

pub unsafe trait Storage: AsRef<[MaybeUninit<Self::Item>]> + AsMut<[MaybeUninit<Self::Item>]> {
    type Item;

    // Required methods
    fn reserve(&mut self, new_capacity: usize);
    fn try_reserve(&mut self, new_capacity: usize) -> AllocResult;
}

A type that can hold Self::Items, and potentially reserve space for more.

Safety

Other safe types rely on this trait being implemented correctly. See the safety requirements on each function

Required Associated Types

type Item

The type of item that this storage can contain

Required Methods

fn reserve(&mut self, new_capacity: usize)

Reserves space for at least new_capacity elements

Safety

After this call successfully ends, the capacity must be at least new_capacity

Panic/Abort

Maybe panic or abort if it is impossible to set the capacity to at least new_capacity

fn try_reserve(&mut self, new_capacity: usize) -> AllocResult

Tries to reserve space for at least new_capacity elements

Safety

If Ok(()) is returned, the capacity must be at least new_capacity

Errors

If enough space cannot be reserved, returns Err(AllocError)

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl<S: ?Sized + Storage> Storage for &mut S

type Item = <S as Storage>::Item

fn reserve(&mut self, new_capacity: usize)

fn try_reserve(&mut self, new_capacity: usize) -> AllocResult

impl<T> Storage for [MaybeUninit<T>]

type Item = T

fn reserve(&mut self, new_capacity: usize)

fn try_reserve(&mut self, capacity: usize) -> AllocResult

impl<T, A: Allocator> Storage for Box<[MaybeUninit<T>], A>

type Item = T

fn reserve(&mut self, new_capacity: usize)

fn try_reserve(&mut self, new_capacity: usize) -> AllocResult

impl<T, const N: usize> Storage for [MaybeUninit<T>; N]

type Item = T

fn reserve(&mut self, capacity: usize)

fn try_reserve(&mut self, capacity: usize) -> AllocResult

Implementors

impl<S: ?Sized + Storage> Storage for BoxStorage<S>

type Item = <S as Storage>::Item