Trait TryPush

pub trait TryPush {
    type Item;
    type Error;
    type ItemView<'a>
       where Self: 'a;

    // Required method
    fn try_push<'a>(
        &'a mut self,
        item: Self::Item,
    ) -> Result<Self::ItemView<'a>, Self::Error>;
}

Abstracts something you can try push item into &mut self

Required Associated Types

type Item

Item stocked in the collection

type Error

The error returned by the collection if push fail

type ItemView<'a> where Self: 'a

Represent a way to access Item in the collection directly after push

Required Methods

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

Try to push an item into a collection, no guarantee on ordering.

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 TryPush for ()

type Error = Infallible

type Item = ()

type ItemView<'a> = ()

fn try_push(&mut self, _: Self::Item) -> Result<Self::ItemView<'_>, Self::Error>

impl TryPush for String

type Error = (<String as TryPush>::Item, TryReserveError)

type Item = char

type ItemView<'a> = <String as TryPush>::Item

fn try_push<'a>( &'a mut self, c: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

impl<Item> TryPush for LinkedList<Item>

type Error = (<LinkedList<Item> as TryPush>::Item, TryReserveError)

type Item = Item

type ItemView<'a> = &'a mut <LinkedList<Item> as TryPush>::Item where Self: 'a

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

impl<Item> TryPush for VecDeque<Item>

type Error = (<VecDeque<Item> as TryPush>::Item, TryReserveError)

type Item = Item

type ItemView<'a> = &'a mut <VecDeque<Item> as TryPush>::Item where Self: 'a

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

impl<Item> TryPush for Vec<Item>

type Error = (<Vec<Item> as TryPush>::Item, TryReserveError)

type Item = Item

type ItemView<'a> = &'a mut <Vec<Item> as TryPush>::Item where Self: 'a

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

impl<Item, const N: usize> TryPush for SmallVec<[Item; N]>

type Error = (<SmallVec<[Item; N]> as TryPush>::Item, CollectionAllocErr)

type Item = Item

type ItemView<'a> = &'a mut <SmallVec<[Item; N]> as TryPush>::Item where Self: 'a

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

impl<Item: Eq + Hash, Seed: BuildHasher> TryPush for HashSet<Item, Seed>

type Error = (<HashSet<Item, Seed> as TryPush>::Item, TryReserveError)

type Item = Item

type ItemView<'a> = bool where Self: 'a

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

impl<Item: Ord> TryPush for BinaryHeap<Item>

type Error = (<BinaryHeap<Item> as TryPush>::Item, TryReserveError)

type Item = Item

type ItemView<'a> = () where Self: 'a

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

impl<Item: Ord> TryPush for BTreeSet<Item>

type Error = (<BTreeSet<Item> as TryPush>::Item, TryReserveError)

type Item = Item

type ItemView<'a> = bool where Self: 'a

fn try_push( &mut self, item: Self::Item, ) -> Result<Self::ItemView<'_>, Self::Error>

impl<Key: Eq + Hash, Value, Seed: BuildHasher> TryPush for HashMap<Key, Value, Seed>

type Error = (<HashMap<Key, Value, Seed> as TryPush>::Item, TryReserveError)

type Item = (Key, Value)

type ItemView<'a> = Option<Value> where Self: 'a

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

impl<Key: Ord, Value> TryPush for BTreeMap<Key, Value>

type Error = (<BTreeMap<Key, Value> as TryPush>::Item, TryReserveError)

type Item = (Key, Value)

type ItemView<'a> = Option<Value> where Self: 'a

fn try_push<'a>( &'a mut self, item: Self::Item, ) -> Result<Self::ItemView<'a>, Self::Error>

Implementors