wasmer 7.1.0

High-performance WebAssembly runtime
Documentation
//! Data types, functions and traits for `v8` runtime's `Table` implementation.
use wasmer_types::TableType;

use crate::{
    AsStoreMut, AsStoreRef, BackendTable, RuntimeError, Value,
    v8::{
        bindings::{self, *},
        utils::convert::{IntoCApiType, IntoCApiValue, IntoWasmerType, IntoWasmerValue},
        vm::VMTable,
    },
    vm::{VMExtern, VMExternTable},
};

use super::check_isolate;

#[derive(Debug, Clone, PartialEq, Eq)]
/// A WebAssembly `table` in the `v8` runtime.
pub struct Table {
    pub(crate) handle: VMTable,
}

unsafe impl Send for Table {}
unsafe impl Sync for Table {}

impl Table {
    pub(crate) fn type_to_v8(ty: TableType) -> *mut wasm_tabletype_t {
        let valtype = unsafe { wasm_valtype_new(ty.ty.into_ct()) };

        let limits = Box::into_raw(Box::new(wasm_limits_t {
            min: ty.minimum,
            max: ty.maximum.unwrap_or_default(),
            shared: false,
        }));

        unsafe { wasm_tabletype_new(valtype, limits) }
    }

    pub fn new(
        store: &mut impl AsStoreMut,
        ty: TableType,
        init: Value,
    ) -> Result<Self, RuntimeError> {
        check_isolate(store);
        let store_mut = store.as_store_mut();
        let v8_store = store_mut.inner.store.as_v8();

        let engine = store_mut.engine();

        let wasm_tablety = Self::type_to_v8(ty);
        let init: wasm_val_t = init.into_cv();

        Ok(Self {
            handle: unsafe { wasm_table_new(v8_store.inner, wasm_tablety, init.of.ref_) },
        })
    }

    pub fn to_vm_extern(&self) -> VMExtern {
        VMExtern::V8(unsafe { wasm_table_as_extern(self.handle) })
    }

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

        let store = store.as_store_ref();

        let table_type: *mut wasm_tabletype_t = unsafe { wasm_table_type(self.handle) };
        let table_limits = unsafe { wasm_tabletype_limits(table_type) };
        let table_type = unsafe { wasm_tabletype_element(table_type) };

        TableType {
            ty: table_type.into_wt(),
            minimum: unsafe { (*table_limits).min },
            maximum: unsafe {
                if (*table_limits).max == 0 {
                    None
                } else {
                    Some((*table_limits).max)
                }
            },
        }
    }

    pub fn get(&self, store: &mut impl AsStoreMut, index: u32) -> Option<Value> {
        check_isolate(store);
        let store_mut = store.as_store_mut();

        unsafe {
            let ref_ = wasm_table_get(self.handle, index);

            if ref_.is_null() {
                return None;
            }

            let kind = match self.ty(store).ty {
                wasmer_types::Type::ExternRef => wasm_valkind_enum_WASM_EXTERNREF,
                wasmer_types::Type::FuncRef => wasm_valkind_enum_WASM_FUNCREF,
                ty => panic!("unsupported table type: {ty:?}"),
            } as u8;

            let value = wasm_val_t {
                kind,
                of: bindings::wasm_val_t__bindgen_ty_1 { ref_ },
            };

            Some(value.into_wv())
        }
    }

    pub fn set(
        &self,
        store: &mut impl AsStoreMut,
        index: u32,
        val: Value,
    ) -> Result<(), RuntimeError> {
        check_isolate(store);
        let store_mut = store.as_store_mut();

        unsafe {
            let init = match val {
                Value::ExternRef(None) | Value::FuncRef(None) => std::ptr::null_mut(),
                Value::FuncRef(Some(ref r)) => wasm_func_as_ref(r.as_v8().handle),
                _ => {
                    return Err(RuntimeError::new(format!(
                        "Could not grow table due to unsupported init value type: {val:?} "
                    )));
                }
            };

            if !wasm_table_set(self.handle, index, init) {
                return Err(RuntimeError::new(format!(
                    "Could not set value {val:?} table at index {index}"
                )));
            }

            Ok(())
        }
    }

    pub fn size(&self, store: &impl AsStoreRef) -> u32 {
        check_isolate(store);
        let store = store.as_store_ref();
        unsafe { wasm_table_size(self.handle) }
    }

    pub fn grow(
        &self,
        store: &mut impl AsStoreMut,
        delta: u32,
        init: Value,
    ) -> Result<u32, RuntimeError> {
        check_isolate(store);
        let store_mut = store.as_store_mut();

        unsafe {
            let size = wasm_table_size(self.handle);
            let init = match init {
                Value::ExternRef(None) | Value::FuncRef(None) => std::ptr::null_mut(),
                Value::FuncRef(Some(r)) => wasm_func_as_ref(r.as_v8().handle),
                _ => {
                    return Err(RuntimeError::new(format!(
                        "Could not grow table due to unsupported init value type: {init:?} "
                    )));
                }
            };
            if !wasm_table_grow(self.handle, delta, init) {
                return Err(RuntimeError::new("Could not grow table"));
            }

            Ok(size)
        }
    }

    pub fn copy(
        _store: &mut impl AsStoreMut,
        _dst_table: &Self,
        _dst_index: u32,
        _src_table: &Self,
        _src_index: u32,
        _len: u32,
    ) -> Result<(), RuntimeError> {
        unimplemented!("Copying tables is currently not implemented!")
    }

    pub(crate) fn from_vm_extern(store: &mut impl AsStoreMut, vm_extern: VMExternTable) -> Self {
        check_isolate(store);
        let store_mut = store.as_store_mut();

        Self {
            handle: vm_extern.into_v8(),
        }
    }

    pub fn is_from_store(&self, store: &impl AsStoreRef) -> bool {
        check_isolate(store);
        true
    }
}

impl crate::Table {
    /// Consume [`self`] into [`crate::backend::v8::table::Table`].
    pub fn into_v8(self) -> crate::backend::v8::table::Table {
        match self.0 {
            BackendTable::V8(s) => s,
            _ => panic!("Not a `v8` table!"),
        }
    }

    /// Convert a reference to [`self`] into a reference [`crate::backend::v8::table::Table`].
    pub fn as_v8(&self) -> &crate::backend::v8::table::Table {
        match &self.0 {
            BackendTable::V8(s) => s,
            _ => panic!("Not a `v8` table!"),
        }
    }

    /// Convert a mutable reference to [`self`] into a mutable reference [`crate::backend::v8::table::Table`].
    pub fn as_v8_mut(&mut self) -> &mut crate::backend::v8::table::Table {
        match &mut self.0 {
            BackendTable::V8(s) => s,
            _ => panic!("Not a `v8` table!"),
        }
    }
}

impl crate::BackendTable {
    /// Consume [`self`] into [`crate::backend::v8::table::Table`].
    pub fn into_v8(self) -> crate::backend::v8::table::Table {
        match self {
            Self::V8(s) => s,
            _ => panic!("Not a `v8` table!"),
        }
    }

    /// Convert a reference to [`self`] into a reference [`crate::backend::v8::table::Table`].
    pub fn as_v8(&self) -> &crate::backend::v8::table::Table {
        match self {
            Self::V8(s) => s,
            _ => panic!("Not a `v8` table!"),
        }
    }

    /// Convert a mutable reference to [`self`] into a mutable reference [`crate::backend::v8::table::Table`].
    pub fn as_v8_mut(&mut self) -> &mut crate::backend::v8::table::Table {
        match self {
            Self::V8(s) => s,
            _ => panic!("Not a `v8` table!"),
        }
    }
}