Struct wasmtime::component::WasmStr

source ·
pub struct WasmStr { /* private fields */ }
Expand description

Representation of a string located in linear memory in a WebAssembly instance.

This type can be used in place of String and str for string-taking APIs in some situations. The purpose of this type is to represent a range of validated bytes within a component but does not actually copy the bytes. The primary method, WasmStr::to_str, attempts to return a reference to the string directly located in the component’s memory, avoiding a copy into the host if possible.

The downside of this type, however, is that accessing a string requires a Store pointer (via StoreContext). Bindings generated by bindgen!, for example, do not have access to StoreContext and thus can’t use this type.

This is intended for more advanced use cases such as defining functions directly in a Linker. It’s expected that in the future bindgen! will also have a way to use this type.

This type is used with TypedFunc, for example, when WebAssembly returns a string. This type cannot be used to give a string to WebAssembly, instead &str should be used for that (since it’s coming from the host).

Note that this type represents an in-bounds string in linear memory, but it does not represent a valid string (e.g. valid utf-8). Validation happens when WasmStr::to_str is called.

Also note that this type does not implement Lower, it only implements Lift.

Implementations§

source§

impl WasmStr

source

pub fn to_str<'a, T: 'a>( &self, store: impl Into<StoreContext<'a, T>>, ) -> Result<Cow<'a, str>>

Returns the underlying string that this cursor points to.

Note that this will internally decode the string from the wasm’s encoding to utf-8 and additionally perform validation.

The store provided must be the store where this string lives to access the correct memory.

§Errors

Returns an error if the string wasn’t encoded correctly (e.g. invalid utf-8).

§Panics

Panics if this string is not owned by store.

Trait Implementations§

Auto Trait Implementations§

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
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where 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.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> Pointable for T

source§

const ALIGN: usize = _

The alignment of pointer.
source§

type Init = T

The type for initializers.
source§

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

Initializes a with the given initializer. Read more
source§

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

Dereferences the given pointer. Read more
source§

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

Mutably dereferences the given pointer. Read more
source§

unsafe fn drop(ptr: usize)

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

impl<T> Same for T

source§

type Output = T

Should always be Self
source§

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

source§

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 T
where U: TryFrom<T>,

source§

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.