Struct wasmer::WasmSlice

source · [−]

pub struct WasmSlice<'a, T: ValueType> { /* private fields */ }

Expand description

Reference to an array of values 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 not required to be aligned: unaligned accesses are fully supported.

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

Implementations

source

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

source

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

Creates a new WasmSlice starting at the given offset in memory and with the given number of elements.

Returns a MemoryAccessError if the slice length overflows.

source

pub fn offset(self) -> u64

Get the offset into Wasm linear memory for this WasmSlice.

source

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

Get a 32-bit WasmPtr for this WasmRef.

source

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

Get a 64-bit WasmPtr for this WasmRef.

source

pub fn len(self) -> u64

Get the number of elements in this slice.

source

pub fn is_empty(self) -> bool

Returns true if the number of elements is 0.

source

pub fn index(self, idx: u64) -> WasmRef<'a, T>

Get a WasmRef to an element in the slice.

source

pub fn subslice(self, range: Range<u64>) -> WasmSlice<'a, T>

Get a WasmSlice for a subslice of this slice.

source

pub fn iter(self) -> WasmSliceIter<'a, T>ⓘNotable traits for WasmSliceIter<'a, T>`impl<'a, T: ValueType> Iterator for WasmSliceIter<'a, T> type Item = WasmRef<'a, T>;`

Get an iterator over the elements in this slice.

source

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

Reads an element of this slice.

source

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

Writes to an element of this slice.

source

pub fn read_slice(self, buf: &mut [T]) -> Result<(), MemoryAccessError>

Reads the entire slice into the given buffer.

The length of the buffer must match the length of the slice.

source

pub fn read_slice_uninit(
self,
buf: &mut [MaybeUninit<T>]
) -> Result<&mut [T], MemoryAccessError>

Reads the entire slice into the given uninitialized buffer.

The length of the buffer must match the length of the slice.

This method returns an initialized view of the buffer.

source

pub fn write_slice(self, data: &[T]) -> Result<(), MemoryAccessError>

Write the given slice into this WasmSlice.

The length of the slice must match the length of the WasmSlice.

source

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

Reads this WasmSlice into a Vec.

Trait Implementations

source

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

source

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

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

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

source

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

Formats the value using the given formatter. Read more

source

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

Auto Trait Implementations

impl<'a, T> !RefUnwindSafe for WasmSlice<'a, T>

impl<'a, T> !Send for WasmSlice<'a, T>

impl<'a, T> !Sync for WasmSlice<'a, T>

impl<'a, T> Unpin for WasmSlice<'a, T>

impl<'a, T> !UnwindSafe for WasmSlice<'a, T>

Blanket Implementations

source

impl<T> Any for T where
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 T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

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

const: unstable · 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 F where
 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

const: unstable · 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 for T where
U: From<T>,

const: unstable · 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> 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> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

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

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

source

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

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::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

Struct wasmer::WasmSlice

Implementations

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

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

pub fn offset(self) -> u64

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

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

pub fn len(self) -> u64

pub fn is_empty(self) -> bool

pub fn index(self, idx: u64) -> WasmRef<'a, T>

pub fn subslice(self, range: Range<u64>) -> WasmSlice<'a, T>

pub fn iter(self) -> WasmSliceIter<'a, T>ⓘNotable traits for WasmSliceIter<'a, T>impl<'a, T: ValueType> Iterator for WasmSliceIter<'a, T> type Item = WasmRef<'a, T>;

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

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

pub fn read_slice(self, buf: &mut [T]) -> Result<(), MemoryAccessError>

pub fn read_slice_uninit( self, buf: &mut [MaybeUninit<T>]) -> Result<&mut [T], MemoryAccessError>

pub fn write_slice(self, data: &[T]) -> Result<(), MemoryAccessError>

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

Trait Implementations

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

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

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

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

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

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

Auto Trait Implementations

impl<'a, T> !RefUnwindSafe for WasmSlice<'a, T>

impl<'a, T> !Send for WasmSlice<'a, T>

impl<'a, T> !Sync for WasmSlice<'a, T>

impl<'a, T> Unpin for WasmSlice<'a, T>

impl<'a, T> !UnwindSafe for WasmSlice<'a, T>

Blanket Implementations

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

fn type_id(&self) -> TypeId

impl<T> ArchivePointee for T

type ArchivedMetadata = ()

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

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

fn borrow(&self) -> &T

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

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

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

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

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

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

fn in_current_span(self) -> Instrumented<Self>

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

fn into(self) -> U

impl<T> Pointable for T

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

type Init = T

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

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

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

unsafe fn drop(ptr: usize)

impl<T> Pointee for T

type Metadata = ()

impl<T> ToOwned for T where T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

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

type Error = Infallible

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

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

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

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

impl<T> WithSubscriber for T

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

fn with_current_subscriber(self) -> WithDispatch<Self>

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

pub fn iter(self) -> WasmSliceIter<'a, T>ⓘNotable traits for WasmSliceIter<'a, T>`impl<'a, T: ValueType> Iterator for WasmSliceIter<'a, T> type Item = WasmRef<'a, T>;`

pub fn read_slice_uninit(
self,
buf: &mut [MaybeUninit<T>]
) -> Result<&mut [T], MemoryAccessError>

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

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

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

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

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

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

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

impl<T> ToOwned for T where
T: Clone,

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

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

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