Struct wasmer::WasmPtr [−][src]
Expand description
A zero-cost type that represents a pointer to something in Wasm linear memory.
This type can be used directly in the host function arguments:
pub fn host_import(memory: Memory, ptr: WasmPtr<u32>) { let derefed_ptr = ptr.deref(&memory).expect("pointer in bounds"); let inner_val: u32 = derefed_ptr.get(); println!("Got {} from Wasm memory address 0x{:X}", inner_val, ptr.offset()); // update the value being pointed to derefed_ptr.set(inner_val + 1); }
This type can also be used with primitive-filled structs, but be careful of
guarantees required by ValueType
.
#[derive(Copy, Clone, Debug)] #[repr(C)] struct V3 { x: f32, y: f32, z: f32 } // This is safe as the 12 bytes represented by this struct // are valid for all bit combinations. unsafe impl ValueType for V3 { } fn update_vector_3(memory: Memory, ptr: WasmPtr<V3>) { let derefed_ptr = ptr.deref(&memory).expect("pointer in bounds"); let mut inner_val: V3 = derefed_ptr.get(); println!("Got {:?} from Wasm memory address 0x{:X}", inner_val, ptr.offset()); // update the value being pointed to inner_val.x = 10.4; derefed_ptr.set(inner_val); }
Implementations
impl<T: Copy + ValueType> WasmPtr<T, Item>
[src]
impl<T: Copy + ValueType> WasmPtr<T, Item>
[src]Methods for WasmPtr
s to data that can be dereferenced, namely to types
that implement ValueType
, meaning that they’re valid for all possible
bit patterns.
pub fn deref<'a>(self, memory: &'a Memory) -> Option<&'a Cell<T>>
[src]
pub fn deref<'a>(self, memory: &'a Memory) -> Option<&'a Cell<T>>
[src]Dereference the WasmPtr
getting access to a &Cell<T>
allowing for
reading and mutating of the inner value.
This method is unsound if used with unsynchronized shared memory. If you’re unsure what that means, it likely does not apply to you. This invariant will be enforced in the future.
pub unsafe fn deref_mut<'a>(self, memory: &'a Memory) -> Option<&'a mut Cell<T>>
[src]
pub unsafe fn deref_mut<'a>(self, memory: &'a Memory) -> Option<&'a mut Cell<T>>
[src]Mutably dereference this WasmPtr
getting a &mut Cell<T>
allowing for
direct access to a &mut T
.
Safety
- This method does not do any aliasing checks: it’s possible to create
&mut T
that point to the same memory. You should ensure that you have exclusive access to Wasm linear memory before calling this method.
impl<T: Copy + ValueType> WasmPtr<T, Array>
[src]
impl<T: Copy + ValueType> WasmPtr<T, Array>
[src]Methods for WasmPtr
s to arrays of data that can be dereferenced, namely to
types that implement ValueType
, meaning that they’re valid for all
possible bit patterns.
pub fn deref(
self,
memory: &Memory,
index: u32,
length: u32
) -> Option<&[Cell<T>]>
[src]
pub fn deref(
self,
memory: &Memory,
index: u32,
length: u32
) -> Option<&[Cell<T>]>
[src]Dereference the WasmPtr
getting access to a &[Cell<T>]
allowing for
reading and mutating of the inner values.
This method is unsound if used with unsynchronized shared memory. If you’re unsure what that means, it likely does not apply to you. This invariant will be enforced in the future.
pub unsafe fn deref_mut(
self,
memory: &Memory,
index: u32,
length: u32
) -> Option<&mut [Cell<T>]>
[src]
pub unsafe fn deref_mut(
self,
memory: &Memory,
index: u32,
length: u32
) -> Option<&mut [Cell<T>]>
[src]Mutably dereference this WasmPtr
getting a &mut [Cell<T>]
allowing for
direct access to a &mut [T]
.
Safety
- This method does not do any aliasing checks: it’s possible to create
&mut T
that point to the same memory. You should ensure that you have exclusive access to Wasm linear memory before calling this method.
pub unsafe fn get_utf8_str<'a>(
self,
memory: &'a Memory,
str_len: u32
) -> Option<&'a str>
[src]
pub unsafe fn get_utf8_str<'a>(
self,
memory: &'a Memory,
str_len: u32
) -> Option<&'a str>
[src]Get a UTF-8 string from the WasmPtr
with the given length.
Note that . The
underlying data can be mutated if the Wasm is allowed to execute or
an aliasing WasmPtr
is used to mutate memory.
Safety
This method returns a reference to Wasm linear memory. The underlying
data can be mutated if the Wasm is allowed to execute or an aliasing
WasmPtr
is used to mutate memory.
str
has invariants that must not be broken by mutating Wasm memory.
Thus the caller must ensure that the backing memory is not modified
while the reference is held.
Additionally, if memory
is dynamic, the caller must also ensure that memory
is not grown while the reference is held.
pub fn get_utf8_string(self, memory: &Memory, str_len: u32) -> Option<String>
[src]
pub fn get_utf8_string(self, memory: &Memory, str_len: u32) -> Option<String>
[src]Get a UTF-8 String
from the WasmPtr
with the given length.
an aliasing WasmPtr
is used to mutate memory.
pub unsafe fn get_utf8_str_with_nul<'a>(
self,
memory: &'a Memory
) -> Option<&'a str>
[src]
pub unsafe fn get_utf8_str_with_nul<'a>(
self,
memory: &'a Memory
) -> Option<&'a str>
[src]Get a UTF-8 string from the WasmPtr
, where the string is nul-terminated.
Note that this does not account for UTF-8 strings that contain nul themselves,
WasmPtr::get_utf8_str
has to be used for those.
Safety
This method behaves similarly to WasmPtr::get_utf8_str
, all safety invariants on
that method must also be upheld here.
pub fn get_utf8_string_with_nul(self, memory: &Memory) -> Option<String>
[src]
pub fn get_utf8_string_with_nul(self, memory: &Memory) -> Option<String>
[src]Get a UTF-8 String
from the WasmPtr
, where the string is nul-terminated.
Note that this does not account for UTF-8 strings that contain nul themselves,
WasmPtr::get_utf8_string
has to be used for those.
Trait Implementations
impl<T: Copy, Ty> FromToNativeWasmType for WasmPtr<T, Ty>
[src]
impl<T: Copy, Ty> FromToNativeWasmType for WasmPtr<T, Ty>
[src]impl<T: Copy, Ty> Copy for WasmPtr<T, Ty>
[src]
impl<T: Copy, Ty> Eq for WasmPtr<T, Ty>
[src]
impl<T: Copy, Ty> ValueType for WasmPtr<T, Ty>
[src]
Auto Trait Implementations
impl<T, Ty> RefUnwindSafe for WasmPtr<T, Ty> where
T: RefUnwindSafe,
Ty: RefUnwindSafe,
T: RefUnwindSafe,
Ty: RefUnwindSafe,
impl<T, Ty> Send for WasmPtr<T, Ty> where
T: Send,
Ty: Send,
T: Send,
Ty: Send,
impl<T, Ty> Sync for WasmPtr<T, Ty> where
T: Sync,
Ty: Sync,
T: Sync,
Ty: Sync,
impl<T, Ty> Unpin for WasmPtr<T, Ty> where
T: Unpin,
Ty: Unpin,
T: Unpin,
Ty: Unpin,
impl<T, Ty> UnwindSafe for WasmPtr<T, Ty> where
T: UnwindSafe,
Ty: UnwindSafe,
T: UnwindSafe,
Ty: UnwindSafe,
Blanket Implementations
impl<T> ArchivePointee for T
impl<T> ArchivePointee for T
type ArchivedMetadata = ()
type ArchivedMetadata = ()
The archived version of the pointer metadata for this type.
pub fn pointer_metadata(
&<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata
pub fn pointer_metadata(
&<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata
Converts some archived metadata to the pointer metadata for itself.
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<Q, K> Equivalent<K> for Q where
K: Borrow<Q> + ?Sized,
Q: Eq + ?Sized,
[src]
impl<Q, K> Equivalent<K> for Q where
K: Borrow<Q> + ?Sized,
Q: Eq + ?Sized,
[src]pub fn equivalent(&self, key: &K) -> bool
[src]
pub fn equivalent(&self, key: &K) -> bool
[src]Compare self to key
and return true
if they are equal.
impl<T> Instrument for T
[src]
impl<T> Instrument for T
[src]fn instrument(self, span: Span) -> Instrumented<Self>
[src]
fn instrument(self, span: Span) -> Instrumented<Self>
[src]Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
fn in_current_span(self) -> Instrumented<Self>
[src]
fn in_current_span(self) -> Instrumented<Self>
[src]impl<T> Pointable for T
impl<T> Pointable for T
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn to_owned(&self) -> T
[src]Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
[src]
pub fn clone_into(&self, target: &mut T)
[src]🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more