Struct Table

pub struct Table { /* private fields */ }

A WasmEdge Table defines a WebAssembly table instance described by its type. A table is an array-like structure and stores function references.

This example shows how to use Table to store and retrieve function references.

Implementations

impl Table

pub fn create(ty: TableType) -> WasmEdgeResult<Self>

Creates a new Table to be associated with the given element type and the size.

Arguments

• ty specifies the type of the new Table.

Error

• If fail to create the table instance, then WasmEdgeError::Table(TableError::Create)(crate::error::TableError) is returned.

pub fn ty(&self) -> WasmEdgeResult<TableType>

Returns the [TableType] of the Table.

Error

If fail to get type, then an error is returned.

pub fn get_data(&self, idx: u32) -> WasmEdgeResult<WasmValue>

Returns the element value at a specific position in the Table.

Arguments

• idx specifies the position in the Table, at which the WasmValue is returned.

Error

If fail to get the data, then an error is returned.

pub fn set_data(&mut self, data: WasmValue, idx: u32) -> WasmEdgeResult<()>

Sets a new element value at a specific position in the Table.

Arguments

• data specifies the new data.

• idx specifies the position of the new data to be stored in the Table.

Error

If fail to set data, then an error is returned.

pub fn capacity(&self) -> usize

Returns the capacity of the Table.

pub fn grow(&mut self, size: u32) -> WasmEdgeResult<()>

Increases the capacity of the Table.

After growing, the new capacity must be in the range defined by limit when the table is created.

Argument

• size specifies the size to be added to the Table.

Error

If fail to increase the size of the Table, then an error is returned.

pub unsafe fn as_ptr(&self) -> *const WasmEdge_TableInstanceContext

Safety

The lifetime of the returned pointer must not exceed that of the object itself.

pub unsafe fn from_raw(ptr: *mut WasmEdge_TableInstanceContext) -> Self

Safety

This function will take over the lifetime management of ptr, so do not call ffi::WasmEdge_TableInstanceDelete on ptr after this.

Trait Implementations

impl Debug for Table

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

Formats the value using the given formatter.

impl Drop for Table

fn drop(&mut self)

Executes the destructor for this type.