Struct wasmer_vm::table::VMTable

pub struct VMTable {
    vec: Vec<RawTableElement>,
    maximum: Option<u32>,
    table: TableType,
    style: TableStyle,
    vm_table_definition: MaybeInstanceOwned<VMTableDefinition>,
}

A table instance.

Fields

vec: Vec<RawTableElement>

maximum: Option<u32>

table: TableType

The WebAssembly table description.

style: TableStyle

Our chosen implementation style.

vm_table_definition: MaybeInstanceOwned<VMTableDefinition>

Implementations

impl VMTable

pub fn new(table: &TableType, style: &TableStyle) -> Result<Self, String>

Create a new linear table instance with specified minimum and maximum number of elements.

This creates a Table with metadata owned by a VM, pointed to by vm_table_location: this can be used to create a local table.

pub fn get_runtime_size(&self) -> u32

Returns the size of the table

pub unsafe fn from_definition( table: &TableType, style: &TableStyle, vm_table_location: NonNull<VMTableDefinition>, ) -> Result<Self, String>

Create a new linear table instance with specified minimum and maximum number of elements.

This creates a Table with metadata owned by a VM, pointed to by vm_table_location: this can be used to create a local table.

Safety

• vm_table_location must point to a valid location in VM memory.

unsafe fn new_inner( table: &TableType, style: &TableStyle, vm_table_location: Option<NonNull<VMTableDefinition>>, ) -> Result<Self, String>

Create a new Table with either self-owned or VM owned metadata.

fn get_vm_table_definition(&self) -> NonNull<VMTableDefinition>

Get the VMTableDefinition.

pub fn ty(&self) -> &TableType

Returns the type for this Table.

pub fn style(&self) -> &TableStyle

Returns the style for this Table.

pub fn size(&self) -> u32

Returns the number of allocated elements.

pub fn grow(&mut self, delta: u32, init_value: TableElement) -> Option<u32>

Grow table by the specified amount of elements.

Returns None if table can’t be grown by the specified amount of elements, otherwise returns the previous size of the table.

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

Get reference to the specified element.

Returns None if the index is out of bounds.

pub fn set(&mut self, index: u32, reference: TableElement) -> Result<(), Trap>

Set reference to the specified element.

Errors

Returns an error if the index is out of bounds.

pub fn vmtable(&self) -> NonNull<VMTableDefinition>

Return a VMTableDefinition for exposing the table to compiled wasm code.

pub fn copy( &mut self, src_table: &Self, dst_index: u32, src_index: u32, len: u32, ) -> Result<(), Trap>

Copy len elements from src_table[src_index..] into dst_table[dst_index..].

Errors

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

pub fn copy_on_write(&self) -> Result<Self, String>

Copies the table into a new table

pub fn copy_within( &mut self, dst_index: u32, src_index: u32, len: u32, ) -> Result<(), Trap>

Copy len elements from table[src_index..] to table[dst_index..].

Errors

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

Trait Implementations

impl Debug for VMTable

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

Formats the value using the given formatter.

impl StoreObject for VMTable

fn list(ctx: &StoreObjects) -> &Vec<Self>

fn list_mut(ctx: &mut StoreObjects) -> &mut Vec<Self>