package wasmer

  1. Overview
  2. Docs

Module Wasmer.InstanceSource

include module type of struct include DeclareRef(Instance_T) end
include module type of struct include DeclareRefBase(Instance_T) end
include module type of struct include DeclareOwn(Instance_T) end
Sourceval name : string

The C name of the structure without the _t suffix.

The C unique (abstract) base type for the structure. the structure type is therefore t structure.

The Ctypes definition of the C structure.

This structure maintains an ownership status. See also WasmerBindings.OwnableObject.

include module type of struct include OwnableObject(O) end

The owning structure type.

Sourceval make_new : unit -> s

Make a new owning structure from a new pointer.

Make a new owning structure from a pointer. See also WasmerBindings.OwnableObject.make_from_unsafe.

Make a new owning structure from a pointer. Does not raise an exception if NULL is given. See also WasmerBindings.OwnableObject.make_from_raise.

Make a new owning structure from a pointer, with an additional data. See also WasmerBindings.OwnableObject.make_from_unsafe_data.

Make a new owning structure from a pointer, with an additional data. Does not raise an exception if NULL is given. See also WasmerBindings.OwnableObject.make_from_raise_data.

Sourceval get_state : s -> object_state

Returns the current ownership state.

Sourceval lose_ownership : s -> unit

Sets the current ownership state to WasmerBindings.object_state.State_PassedAway. Ignores the current ownership.

grab_ownership self gives the ownership of the pointed object to the caller code. It is equivalent to let p = get_ptr self in lose_ownership self; p, but with additional checks for the current ownership.

  • returns

    The pointer

Deletes the object if required, then sets the ownership to WasmerBindings.object_state.State_Owned and returns the pointer. This is only to be used in own-out function arguments in the C API or equivalent.

  • returns

    A deleted or given-away pointer.

  • raises Invalid_access

    If the current state is WasmerBindings.object_state.State_Dependent

Sourceval is_null : s -> bool

Returns Ctypes.is_null on the underlying pointer, ignoring the current ownership state.

Returns the underlying pointer, requiring a sufficient ownership state.

  • raises Invalid_access

    If the current state is lower than WasmerBindings.object_state.State_RW

Returns the underlying pointer, requiring a sufficient ownership state.

  • raises Invalid_access

    If the current state is lower than WasmerBindings.object_state.State_Const

Inherently unsafe function that returns a given-away pointer.

  • raises Invalid_access

    If the current state is not WasmerBindings.object_state.State_PassedAway

Sourceval delete : s -> unit

Frees the underlying pointer. A side effect is to mark the object as given away.

Sourceval duplicate : s -> s
Sourceval duplicate_unsafe : s -> s
Sourceval same : s -> s -> bool
Sourceval get_host_info : s -> unit Ctypes.ptr
Sourceval set_host_info : s -> unit Ctypes.ptr -> unit
Sourceval set_host_info_with_finalizer : s -> unit Ctypes.ptr -> (unit Ctypes.ptr -> unit) -> unit

Finalizers will not get GC'd (so long as they are called once)

Sourceval to_ref : s -> Ref.s
Sourceval of_ref : Ref.s -> s
Sourceval to_ref_const : s -> Ref.s
Sourceval of_ref_const : Ref.s -> s
Sourceval new_ : Store.s -> Module.s -> Extern.Vec.s -> (s, Trap.s option) result
Sourceval new_unsafe : Store.s -> Module.s -> Extern.Vec.s -> (s, Trap.s) result
Sourceval exports : s -> Extern.Vec.s -> unit