Struct Stack 

pub struct Stack { /* private fields */ }

Stack for the VM with configurable size limit

Implementations

impl Stack

pub fn new(max_size: usize) -> Self

Create a new stack with the given maximum size

pub fn push(&mut self, value: Value) -> Result<(), StackError>

Push a value onto the stack

pub fn pop(&mut self) -> Result<Value, StackError>

Pop a value from the stack

pub fn peek(&self) -> Result<&Value, StackError>

Peek at the top value without removing it

pub fn peek_n(&self, n: usize) -> Result<&Value, StackError>

Peek at the nth value from the top (0 = top)

pub fn dup(&mut self) -> Result<(), StackError>

Duplicate the top value

pub fn swap(&mut self) -> Result<(), StackError>

Swap the top two values

pub fn depth(&self) -> usize

Get the current stack depth

pub fn clear(&mut self)

Clear the stack

pub fn slice_from(&self, bp: usize) -> &[Value]

Get a slice of the stack from a base pointer

pub fn pop_n(&mut self, n: usize) -> Result<Vec<Value>, StackError>

Remove multiple items from the top

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

Truncate stack to a specific depth

Trait Implementations

impl Clone for Stack

fn clone(&self) -> Stack

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Stack

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.