package wasmer

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

Parameters
Signature

package wasmer

wasmer
- Wasmer
  - Byte
    
    V
    
    Vec
  - Config
  - Config_T
  - DeclareOwn
    
    T
  - DeclareRef
    
    T
  - DeclareRefBase
    
    T
  - DeclareShareableRef
    
    S
    
    Shared
    
    T
  - DeclareType
    
    T
    
    V
    
    Vec
  - DeclareVec
    
    U
  - Engine
  - Engine_T
  - Exporttype
  - Exporttype_T
  - Extern
    
    V
    
    Vec
  - Extern_T
  - Externkind
  - Externtype
  - Externtype_T
  - Foreign
  - Foreign_T
  - Frame
    
    V
    
    Vec
  - Frame_T
  - Func
  - Func_T
  - Functype
  - Functype_T
  - Global
  - Global_T
  - Globaltype
  - Globaltype_T
  - Importtype
  - Importtype_T
  - Instance
  - Instance_T
  - Limits
  - Memory
  - Memory_T
  - Memorytype
  - Memorytype_T
  - Message
  - Module
  - Module_T
  - Mutability
  - Name
  - ObjectType
  - OwnableObject
    
    O
  - Ref
    
    O
  - Ref_T
  - Store
  - Store_T
  - StructType
  - Table
  - Table_T
  - Tabletype
  - Tabletype_T
  - Trap
  - Trap_T
  - Util
  - Val
    
    Anon0
    
    O
    
    V
    
    Vec
  - Valkind
  - Valtype
  - Valtype_T
  - VectorType
  - Wasi
    
    Config
    
    O
    
    Config_T
    
    Env
    
    Env_T
    
    NamedExtern
    
    O
    
    V
    
    Vec
    
    O
    
    NamedExtern_T
  - Wasi_
    
    Env_
    
    Env_O_

Legend:
Library
Module
Module type
Parameter
Class
Class type

The base WASM objects, declared in wasm.h as WASM_DECLARE_OWN.

Parameters

module T : StructType

Signature

val name : string

The C name of the structure without the _t suffix.

type t

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

val t : t Ctypes.structure Ctypes.typ

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}4) end

Ownable objects are the basic structure that maintains an ownership state on C objects.

type s

The owning structure type.

val make_new : unit -> s

Make a new owning structure from a new pointer.

val make_from_raise : t Ctypes.structure Ctypes.ptr -> object_state -> s

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

raises Returned_null
If the pointer is NULL

val make_from_unsafe : t Ctypes.structure Ctypes.ptr -> object_state -> s

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

val make_from_raise_data : 
  t Ctypes.structure Ctypes.ptr ->
  object_state ->
  T.d ->
  s

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

raises Returned_null
If the pointer is NULL

val make_from_unsafe_data : 
  t Ctypes.structure Ctypes.ptr ->
  object_state ->
  T.d ->
  s

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.

val get_state : s -> object_state

Returns the current ownership state.

val lose_ownership : s -> unit

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

val grab_ownership : s -> t Ctypes.structure Ctypes.ptr

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

val gain_ownership_back : s -> t Ctypes.structure Ctypes.ptr

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

val is_null : s -> bool

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

val get_ptr : s -> t Ctypes.structure Ctypes.ptr

Returns the underlying pointer, requiring a sufficient ownership state.

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

val get_ptr_const : s -> t Ctypes.structure Ctypes.ptr

Returns the underlying pointer, requiring a sufficient ownership state.

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

val get_ptr_givenaway : s -> t Ctypes.structure Ctypes.ptr

Inherently unsafe function that returns a given-away pointer.

raises Invalid_access
If the current state is not WasmerBindings.object_state.State_PassedAway

val delete : s -> unit

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