Struct Stack 

pub struct Stack { /* private fields */ }

A bounded stack of PsObject values.

Implementations

impl Stack

pub fn new(max_size: usize) -> Self

pub fn push(&mut self, obj: PsObject) -> Result<(), PsError>

Push an object, returning StackOverflow if full.

pub fn insert_at(&mut self, index: usize, obj: PsObject) -> Result<(), PsError>

Insert an object at a specific index from the bottom.

Used by the ExecArray inner loop to insert a continuation cursor below items that an operator just pushed to e_stack.

pub fn pop(&mut self) -> Result<PsObject, PsError>

Pop the top object, returning StackUnderflow if empty.

pub fn try_pop(&mut self) -> Option<PsObject>

Try to pop — returns None if empty (no error).

pub fn peek(&self, from_top: usize) -> Result<PsObject, PsError>

Peek at an object relative to top. 0 = top, 1 = second from top, etc.

pub fn peek_mut(&mut self, from_top: usize) -> Result<&mut PsObject, PsError>

Mutable peek at an object relative to top.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn clear(&mut self)

pub fn set_max_size(&mut self, max_size: usize)

Update the maximum stack size.

pub fn as_slice(&self) -> &[PsObject]

pub fn as_mut_slice(&mut self) -> &mut [PsObject]

pub fn truncate(&mut self, len: usize)

pub fn swap_top_two(&mut self) -> Result<(), PsError>

Swap the top two elements (for exch).

pub fn max_size(&self) -> usize

Max capacity of this stack.