Struct ocaml::Pointer

#[repr(transparent)]
pub struct Pointer<'a, T>(pub Value, _);

A handle to a Rust value/reference owned by the OCaml heap.

This should only be used with values allocated with alloc_final or alloc_custom, for abstract pointers see Value::alloc_abstract_ptr and Value::abstract_ptr_val

Tuple Fields

0: Value

Implementations

impl<'a, T> Pointer<'a, T>

pub fn alloc_final(
    x: T,
    finalizer: Option<unsafe extern "C" fn(_: Raw)>,
    used_max: Option<(usize, usize)>
) -> Pointer<'a, T>

Allocate a new value with an optional custom finalizer and used/max

This calls caml_alloc_final under-the-hood, which can has less than ideal performance behavior. In most cases you should prefer Poiner::alloc_custom when possible.

pub fn alloc_custom(x: T) -> Pointer<'a, T> where
    T: Custom, 

Allocate a Custom value

pub unsafe fn drop_in_place(self)

Drop pointer in place

Safety

This should only be used when you’re in control of the underlying value and want to drop it. It should only be called once.

pub fn set(&mut self, x: T)

Replace the inner value with the provided argument

pub fn as_ptr(&self) -> *const T

Access the underlying pointer

pub fn as_mut_ptr(&mut self) -> *mut T

Access the underlying mutable pointer

Trait Implementations

impl<'a, T> AsMut<T> for Pointer<'a, T>

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

Converts this type into a mutable reference of the (usually inferred) input type.

impl<'a, T> AsRef<T> for Pointer<'a, T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a, T: Clone> Clone for Pointer<'a, T>

fn clone(&self) -> Pointer<'a, T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, T> FromValue<'a> for Pointer<'a, T>

fn from_value(value: Value) -> Self

Convert from OCaml value

impl<'a, T> IntoValue for Pointer<'a, T>

fn into_value(self, _rt: &Runtime) -> Value

Convert to OCaml value

impl<'a, T: PartialEq> PartialEq<Pointer<'a, T>> for Pointer<'a, T>

fn eq(&self, other: &Pointer<'a, T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Pointer<'a, T>) -> bool

This method tests for !=.

impl<'a, T> StructuralPartialEq for Pointer<'a, T>