Struct Table

pub struct Table(/* private fields */);

A WebAssembly table instance.

The Table struct is an array-like structure representing a WebAssembly Table, which stores function references.

A table created by the host or in WebAssembly code will be accessible and mutable from both host and WebAssembly.

Spec: https://webassembly.github.io/spec/core/exec/runtime.html#table-instances

Implementations

impl Table

pub fn new( store: &mut impl AsStoreMut, ty: TableType, init: Value, ) -> Result<Self, RuntimeError>

Creates a new Table with the provided TableType definition.

All the elements in the table will be set to the init value.

This function will construct the Table using the store BaseTunables.

pub fn ty(&self, store: &impl AsStoreRef) -> TableType

Returns the TableType of the Table.

pub fn get(&self, store: &mut impl AsStoreMut, index: u32) -> Option<Value>

Retrieves an element of the table at the provided index.

pub fn set( &self, store: &mut impl AsStoreMut, index: u32, val: Value, ) -> Result<(), RuntimeError>

Sets an element val in the Table at the provided index.

pub fn size(&self, store: &impl AsStoreRef) -> u32

Retrieves the size of the Table (in elements)

pub fn grow( &self, store: &mut impl AsStoreMut, delta: u32, init: Value, ) -> Result<u32, RuntimeError>

Grows the size of the Table by delta, initializating the elements with the provided init value.

It returns the previous size of the Table in case is able to grow the Table successfully.

Errors

Returns an error if the delta is out of bounds for the table.

pub fn copy( store: &mut impl AsStoreMut, dst_table: &Self, dst_index: u32, src_table: &Self, src_index: u32, len: u32, ) -> Result<(), RuntimeError>

Copies the len elements of src_table starting at src_index to the destination table dst_table at index dst_index.

Errors

Returns an error if the range is out of bounds of either the source or destination tables.

pub fn is_from_store(&self, store: &impl AsStoreRef) -> bool

Checks whether this Table can be used with the given context.

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<'a> Exportable<'a> for Table

fn get_self_from_extern(_extern: &'a Extern) -> Result<&'a Self, ExportError>

Implementation of how to get the export corresponding to the implementing type from an Instance by name.

impl From<Table> for Extern

fn from(r: Table) -> Self

Converts to this type from the input type.

impl PartialEq for Table

fn eq(&self, other: &Table) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Table

impl StructuralPartialEq for Table