Struct wasmer::MemoryView

source ·
pub struct MemoryView<'a>(_);
Expand description

A WebAssembly memory view.

A memory view is used to read and write to the linear memory.

After a memory is grown a view must not be used anymore. Views are created using the Memory.grow() method.

Implementations§

source§

impl<'a> MemoryView<'a>

source

pub fn data_size(&self) -> u64

Returns the size (in bytes) of the Memory.

source

pub fn size(&self) -> Pages

Returns the size (in Pages) of the Memory.

Example
let m = Memory::new(&mut store, MemoryType::new(1, None, false)).unwrap();

assert_eq!(m.view(&mut store).size(), Pages(1));
source

pub fn read(&self, offset: u64, buf: &mut [u8]) -> Result<(), MemoryAccessError>

Safely reads bytes from the memory at the given offset.

The full buffer will be filled, otherwise a MemoryAccessError is returned to indicate an out-of-bounds access.

This method is guaranteed to be safe (from the host side) in the face of concurrent writes.

source

pub fn read_u8(&self, offset: u64) -> Result<u8, MemoryAccessError>

Safely reads a single byte from memory at the given offset

This method is guaranteed to be safe (from the host side) in the face of concurrent writes.

source

pub fn read_uninit<'b>( &self, offset: u64, buf: &'b mut [MaybeUninit<u8>] ) -> Result<&'b mut [u8], MemoryAccessError>

Safely reads bytes from the memory at the given offset.

This method is similar to read but allows reading into an uninitialized buffer. An initialized view of the buffer is returned.

The full buffer will be filled, otherwise a MemoryAccessError is returned to indicate an out-of-bounds access.

This method is guaranteed to be safe (from the host side) in the face of concurrent writes.

source

pub fn write(&self, offset: u64, data: &[u8]) -> Result<(), MemoryAccessError>

Safely writes bytes to the memory at the given offset.

If the write exceeds the bounds of the memory then a MemoryAccessError is returned.

This method is guaranteed to be safe (from the host side) in the face of concurrent reads/writes.

source

pub fn write_u8(&self, offset: u64, val: u8) -> Result<(), MemoryAccessError>

Safely writes a single byte from memory at the given offset

This method is guaranteed to be safe (from the host side) in the face of concurrent writes.

source

pub fn copy_to_vec(&self) -> Result<Vec<u8>, MemoryAccessError>

Copies the memory and returns it as a vector of bytes

source

pub fn copy_to_memory( &self, amount: u64, new_memory: &Self ) -> Result<(), MemoryAccessError>

Copies the memory to another new memory object

Trait Implementations§

source§

impl<'a> Debug for MemoryView<'a>

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<'a> RefUnwindSafe for MemoryView<'a>

§

impl<'a> !Send for MemoryView<'a>

§

impl<'a> !Sync for MemoryView<'a>

§

impl<'a> Unpin for MemoryView<'a>

§

impl<'a> UnwindSafe for MemoryView<'a>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
§

impl<T> ArchivePointee for T

§

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.
§

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere W: DeserializeWith<F, T, D>, D: Fallible + ?Sized, F: ?Sized,

§

fn deserialize( &self, deserializer: &mut D ) -> Result<With<T, W>, <D as Fallible>::Error>

Deserializes using the given deserializer
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> LayoutRaw for T

§

fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>

Gets the layout of the type.
§

impl<T> Pointable for T

§

const ALIGN: usize = mem::align_of::<T>()

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> Pointee for T

§

type Metadata = ()

The type for metadata in pointers and references to Self.
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more