Struct wasmedge_sdk::Caller

pub struct Caller { /* private fields */ }

Represents the calling frame on top of stack.

The Caller object is only used as the first argument when defining a host function. With this argument, developers can have access to the Executor instance, the Instance instance, and the Memory instance inside the host functions they defined.

Implementations

impl Caller

pub fn new(frame: CallingFrame) -> Self

Creates a Caller instance with the given CallingFrame instance.

Caller vs. CallingFrame

CallingFrame is a low-level type defined in wasmedge-sys crate, while Caller is a high-level type. For developers using the APIs in wasmedge-sdk, they should create a Caller instance with the given CallingFrame instance, as Caller provides APIs to access high-level instances, such as executor and memory, related to the current calling frame.

pub fn executor(&self) -> Option<&Executor>

Returns the executor instance from this caller.

pub fn executor_mut(&mut self) -> Option<&mut Executor>

Returns the mutable executor instance from this caller.

pub fn instance(&self) -> Option<&Instance>

Returns the module instance in this caller.

pub fn instance_mut(&mut self) -> Option<&mut Instance>

Returns the mutable module instance in this caller.

pub fn memory(&self, idx: u32) -> Option<Memory>

Returns the memory instance by the given index from the module instance of this caller. If the memory instance is not found, then return None.

Arguments

• idx - The index of the memory instance. By default, a WASM module has only one memory instance after instantiation. Therefore, users can pass in 0 as the index to get the memory instance in host function body. When the MultiMemories config option is enabled, there would be more than one memory instances in the wasm module. Users can retrieve the target memory instance by specifying the index of the memory instance in the wasm module instance.

Trait Implementations

impl Debug for Caller

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

Formats the value using the given formatter.

impl From<CallingFrame> for Caller

fn from(frame: CallingFrame) -> Self

Converts to this type from the input type.