Struct wasmer::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: &Store,
    ty: TableType,
    init: Val
) -> 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) -> &TableType

Returns the TableType of the Table.

pub fn store(&self) -> &Store

Returns the Store where the Table belongs.

pub fn get(&self, index: u32) -> Option<Val>

Retrieves an element of the table at the provided index.

pub fn set(&self, index: u32, val: Val) -> Result<(), RuntimeError>

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

pub fn size(&self) -> u32

Retrieves the size of the Table (in elements)

pub fn grow(&self, delta: u32, init: Val) -> 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(
    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 same(&self, other: &Self) -> bool

Returns whether or not these two tables refer to the same data.

Trait Implementations

impl Clone for Table

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Exportable<'a> for Table

fn to_export(&self) -> Export

This function is used when providedd the Extern as exportable, so it can be used while instantiating the Module.

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.

fn into_weak_instance_ref(&mut self)

Convert the extern internally to hold a weak reference to the InstanceRef. This is useful for preventing cycles, for example for data stored in a type implementing WasmerEnv.

impl From<Table> for Extern

fn from(r: Table) -> Self

Performs the conversion.

impl MemoryUsage for Table

fn size_of_val(&self, visited: &mut dyn MemoryUsageTracker) -> usize

Returns the size of the referenced value in bytes.