package wasmer

  1. Overview
  2. Docs
type t
module Anon0 : sig ... end
module O : ObjectType with type t = t Ctypes.structure
include module type of struct include OwnableObject(O) end

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

The owning structure type.

val make_new : unit -> s

Make a new owning structure from a new pointer.

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

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

val make_from_unsafe : O.t 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 : O.t Ctypes.ptr -> object_state -> O.d -> s

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

val make_from_unsafe_data : O.t Ctypes.ptr -> object_state -> O.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 -> O.t 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 -> O.t 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 -> O.t 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 -> O.t 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 -> O.t 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.

val of_i32 : int32 -> s
val of_i64 : int64 -> s
val of_f32 : float -> s
val of_f64 : float -> s
val of_ref : Ref.s -> s
val new_ : unit -> s
type ocaml =
  1. | I32 of int32
  2. | I64 of int64
  3. | F32 of float
  4. | F64 of float
  5. | Ref of Ref.s
val get_kind : s -> Valkind.ocaml
val get_i32 : s -> int32
val get_i64 : s -> int64
val get_f32 : s -> float
val get_f64 : s -> float
val get_ref : s -> Ref.s
val of_c : s -> ocaml
val to_c : ocaml -> s
val duplicate : s -> s
module V : VectorType with type data_type = t Ctypes.structure with type owning_struct = s
module Vec : sig ... end
OCaml

Innovation. Community. Security.