Struct wasmer::WasmRef

pub struct WasmRef<'a, T: ValueType> {
    pub(crate) buffer: MemoryBuffer<'a>,
    pub(crate) offset: u64,
    marker: PhantomData<*mut T>,
}

Reference to a value in Wasm memory.

The type of the value must satisfy the requirements of the ValueType trait which guarantees that reading and writing such a value to untrusted memory is safe.

The address is required to be aligned: unaligned accesses cause undefined behavior.

This wrapper safely handles concurrent modifications of the data by another thread.

Fields

buffer: MemoryBuffer<'a>

offset: u64

marker: PhantomData<*mut T>

Implementations

impl<'a, T: ValueType> WasmRef<'a, T>

pub fn new(view: &'a MemoryView<'_>, offset: u64) -> Self

Creates a new WasmRef at the given offset in a memory.

pub fn offset(self) -> u64

Get the offset into Wasm linear memory for this WasmRef.

pub fn as_ptr32(self) -> WasmPtr<T, Memory32>

Get a WasmPtr for this WasmRef.

pub fn as_ptr64(self) -> WasmPtr<T, Memory64>

Get a 64-bit WasmPtr for this WasmRef.

pub fn as_ptr<M: MemorySize>(self) -> WasmPtr<T, M>

Get a WasmPtr for this WasmRef.

pub fn read(self) -> Result<T, MemoryAccessError>

Reads the location pointed to by this WasmRef.

pub fn write(self, val: T) -> Result<(), MemoryAccessError>

Writes to the location pointed to by this WasmRef.

pub fn access(self) -> Result<WasmRefAccess<'a, T>, MemoryAccessError>

Gains direct access to the memory of this slice

Trait Implementations

impl<'a, T: Clone + ValueType> Clone for WasmRef<'a, T>

fn clone(&self) -> WasmRef<'a, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, T: ValueType> Debug for WasmRef<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: Copy + ValueType> Copy for WasmRef<'a, T>