Struct dynstack::DynStack

pub struct DynStack<T: ?Sized> { /* fields omitted */ }

Methods

impl<T: ?Sized> DynStack<T>

pub fn new() -> Self

Creates a new, empty, DynStack.

Panics

Panics if T is not a trait object.

pub unsafe fn push(&mut self, item: *mut T)

Push a trait object onto the stack.

This method is unsafe because in lieu of moving a trait object onto push's stack (not possible in rust as of 1.30.0) we copy it from the provided mutable pointer.

The user of this method must therefore either ensure that item has no Drop impl, or explicitly call std::mem::forget on item after pushing.

It is highly recommended to use the dyn_push macro instead of calling this directly.

pub fn remove_last(&mut self) -> bool

Remove the last trait object from the stack. Returns true if any items were removed.

pub fn get<'a>(&'a self, index: usize) -> Option<&'a T>

Retrieve a trait object reference at the provided index.

pub fn get_mut<'a>(&'a mut self, index: usize) -> Option<&'a mut T>

Retrieve a mutable trait object reference at the provided index.

pub fn peek<'a>(&'a self) -> Option<&'a T>

Retrieve the trait object reference at the top of the stack.

pub fn peek_mut<'a>(&'a mut self) -> Option<&'a mut T>

Retrieve the mutable trait object reference at the top of the stack.

pub fn len(&self) -> usize

Returns the number of trait objects stored on the stack.

impl<'a, T: 'a + ?Sized> DynStack<T>

Important traits for DynStackIter<'a, T>

impl<'a, T: 'a + ?Sized> Iterator for DynStackIter<'a, T> type Item = &'a T;

pub fn iter(&'a self) -> DynStackIter<'a, T>

Returns an iterator over trait object references

Important traits for DynStackIterMut<'a, T>

impl<'a, T: 'a + ?Sized> Iterator for DynStackIterMut<'a, T> type Item = &'a mut T;

pub fn iter_mut(&'a mut self) -> DynStackIterMut<'a, T>

Returns an iterator over mutable trait object references

Trait Implementations

impl<'a, T: 'a + ?Sized> IntoIterator for &'a DynStack<T>

type Item = &'a T

The type of the elements being iterated over.

type IntoIter = DynStackIter<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T: 'a + ?Sized> IntoIterator for &'a mut DynStack<T>

type Item = &'a mut T

The type of the elements being iterated over.

type IntoIter = DynStackIterMut<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: ?Sized> Drop for DynStack<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: ?Sized> Index<usize> for DynStack<T>

type Output = T

The returned type after indexing.

fn index(&self, idx: usize) -> &T

Performs the indexing (container[index]) operation.

impl<T: ?Sized> IndexMut<usize> for DynStack<T>

fn index_mut(&mut self, idx: usize) -> &mut T

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