Trait kernel::types::ForeignOwnable

pub trait ForeignOwnable: Sized {
    type Borrowed<'a>;

    fn into_foreign(self) -> *const c_void;
    unsafe fn borrow<'a>(ptr: *const c_void) -> Self::Borrowed<'a>;
    unsafe fn from_foreign(ptr: *const c_void) -> Self;

    unsafe fn borrow_mut(ptr: *const c_void) -> ScopeGuard<Self, fn(_: Self)> { ... }
}

Used to transfer ownership to and from foreign (non-Rust) languages.

Ownership is transferred from Rust to a foreign language by calling Self::into_foreign and later may be transferred back to Rust by calling Self::from_foreign.

This trait is meant to be used in cases when Rust objects are stored in C objects and eventually “freed” back to Rust.

Required Associated Types

type Borrowed<'a>

Type of values borrowed between calls to ForeignOwnable::into_foreign and ForeignOwnable::from_foreign.

Required Methods

fn into_foreign(self) -> *const c_void

Converts a Rust-owned object to a foreign-owned one.

The foreign representation is a pointer to void.

unsafe fn borrow<'a>(ptr: *const c_void) -> Self::Borrowed<'a>

Borrows a foreign-owned object.

Safety

ptr must have been returned by a previous call to ForeignOwnable::into_foreign for which a previous matching ForeignOwnable::from_foreign hasn’t been called yet. Additionally, all instances (if any) of values returned by ForeignOwnable::borrow_mut for this object must have been dropped.

unsafe fn from_foreign(ptr: *const c_void) -> Self

Converts a foreign-owned object back to a Rust-owned one.

Safety

ptr must have been returned by a previous call to ForeignOwnable::into_foreign for which a previous matching ForeignOwnable::from_foreign hasn’t been called yet. Additionally, all instances (if any) of values returned by ForeignOwnable::borrow and ForeignOwnable::borrow_mut for this object must have been dropped.

Provided Methods

unsafe fn borrow_mut(ptr: *const c_void) -> ScopeGuard<Self, fn(_: Self)>

Mutably borrows a foreign-owned object.

Safety

ptr must have been returned by a previous call to ForeignOwnable::into_foreign for which a previous matching ForeignOwnable::from_foreign hasn’t been called yet. Additionally, all instances (if any) of values returned by ForeignOwnable::borrow and ForeignOwnable::borrow_mut for this object must have been dropped.

Implementations on Foreign Types

impl<T: 'static> ForeignOwnable for Box<T>

type Borrowed<'a> = &'a T

fn into_foreign(self) -> *const c_void

unsafe fn borrow<'a>(ptr: *const c_void) -> &'a T

unsafe fn from_foreign(ptr: *const c_void) -> Self

impl ForeignOwnable for ()

type Borrowed<'a> = ()

fn into_foreign(self) -> *const c_void

unsafe fn borrow<'a>(_: *const c_void) -> Self::Borrowed<'a>

unsafe fn from_foreign(_: *const c_void) -> Self

impl<T: ForeignOwnable + Deref> ForeignOwnable for Pin<T>

type Borrowed<'a> = <T as ForeignOwnable>::Borrowed<'a>

fn into_foreign(self) -> *const c_void

unsafe fn borrow<'a>(ptr: *const c_void) -> Self::Borrowed<'a>

unsafe fn from_foreign(p: *const c_void) -> Self

impl<T> ForeignOwnable for *mut T

type Borrowed<'a> = *mut T

fn into_foreign(self) -> *const c_void

unsafe fn borrow<'a>(ptr: *const c_void) -> Self::Borrowed<'a>

unsafe fn from_foreign(ptr: *const c_void) -> Self

Implementors

impl<T: 'static> ForeignOwnable for Arc<T>

type Borrowed<'a> = ArcBorrow<'a, T>