Struct ic_stable_structures::vec::Vec

pub struct Vec<T: BoundedStorable, M: Memory> { /* private fields */ }

An implementation of growable arrays in stable memory.

Implementations

impl<T: BoundedStorable, M: Memory> Vec<T, M>

pub fn new(memory: M) -> Result<Self, GrowFailed>

Creates a new empty vector in the specified memory, overwriting any data structures the memory might have contained previously.

Complexity: O(1)

pub fn init(memory: M) -> Result<Self, InitError>

Initializes a vector in the specified memory.

Complexity: O(1)

PRECONDITION: the memory is either empty or contains a valid stable vector.

pub fn into_memory(self) -> M

Returns the underlying memory instance.

pub fn is_empty(&self) -> bool

Returns true if the vector is empty.

Complexity: O(1)

pub fn len(&self) -> usize

Returns the number of items in the vector.

Complexity: O(1)

pub fn set(&self, index: usize, item: &T)

Sets the item at the specified index to the specified value.

Complexity: O(T::MAX_SIZE)

PRECONDITION: index < self.len()

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

Returns the item at the specified index.

Complexity: O(T::MAX_SIZE)

pub fn push(&self, item: &T) -> Result<(), GrowFailed>

Adds a new item at the end of the vector.

Complexity: O(T::MAX_SIZE)

pub fn pop(&self) -> Option<T>

Removes the item at the end of the vector.

Complexity: O(T::MAX_SIZE)

pub fn iter(&self) -> Iter<'_, T, M>

Trait Implementations

impl<T: BoundedStorable + Debug, M: Memory> Debug for Vec<T, M>

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

Formats the value using the given formatter.