Struct soroban_wasmi::Table

#[repr(transparent)]
pub struct Table(_);

A Wasm table reference.

Implementations

impl Table

pub fn new(ctx: impl AsContextMut, table_type: TableType) -> Self

Creates a new table to the store.

pub fn table_type(&self, ctx: impl AsContext) -> TableType

Returns the type and limits of the table.

Panics

Panics if ctx does not own this Table.

pub fn len(&self, ctx: impl AsContext) -> usize

Returns the current length of the table.

Note

The returned length must be valid within the resizable limits of the table entity.

Panics

Panics if ctx does not own this Table.

pub fn grow(
    &self,
    ctx: impl AsContextMut,
    grow_by: usize
) -> Result<(), TableError>

Grows the table by the given amount of elements.

Note

The newly added elements are initialized to None.

Errors

If the table is grown beyond its maximum limits.

Panics

Panics if ctx does not own this Table.

pub fn get(
    &self,
    ctx: impl AsContext,
    offset: usize
) -> Result<Option<Func>, TableError>

Returns the element at the given offset if any.

Errors

If the accesses element is out of bounds of the table.

Panics

Panics if ctx does not own this Table.

pub fn set(
    &self,
    ctx: impl AsContextMut,
    offset: usize,
    new_value: Option<Func>
) -> Result<(), TableError>

Sets a new value to the table element at the given offset.

Errors

If the accesses element is out of bounds of the table.

Panics

Panics if ctx does not own this Table.

Trait Implementations

impl Clone for Table

fn clone(&self) -> Table

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Table

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

Formats the value using the given formatter.

impl From<Table> for Extern

fn from(table: Table) -> Self

Converts to this type from the input type.

impl Copy for Table