Trait IsPtr

pub trait IsPtr {
    type T: ?Sized;

    // Required methods
    fn into_raw_ptr(this: Self) -> NonNull<Self::T>;
    unsafe fn from_raw_ptr(ptr: NonNull<Self::T>) -> Self;

    // Provided method
    fn on_killed(_this: &Self) { ... }
}

Implemented for any owning pointer which can be dereferenced as T.

Safety

When accepting an unknown impl IsPtr, be aware of the various guarantees expected by all implementors. In particular, it may not be safe to mutate the pointer since Pin<T>: IsPtr.

Required Associated Types

type T: ?Sized

Required Methods

fn into_raw_ptr(this: Self) -> NonNull<Self::T>

Converts to the raw pointer.

unsafe fn from_raw_ptr(ptr: NonNull<Self::T>) -> Self

Converts from the raw pointer. This is used mainly to call drop.

Safety

The given pointer must have been returned by Self::into_raw_ptr.

Provided Methods

fn on_killed(_this: &Self)

An optional handler for when Own<Self> is dropped.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl IsPtr for ()

type T = ()

fn into_raw_ptr(_: Self) -> NonNull<Self::T>

unsafe fn from_raw_ptr(_: NonNull<Self::T>) -> Self

impl IsPtr for String

type T = str

fn into_raw_ptr(this: Self) -> NonNull<str>

unsafe fn from_raw_ptr(ptr: NonNull<str>) -> Self

impl IsPtr for PathBuf

type T = Path

fn into_raw_ptr(this: Self) -> NonNull<Path>

unsafe fn from_raw_ptr(ptr: NonNull<Path>) -> Self

impl<P: IsPtr + Deref> IsPtr for Pin<P>

type T = <P as IsPtr>::T

fn into_raw_ptr(this: Self) -> NonNull<P::T>

unsafe fn from_raw_ptr(ptr: NonNull<P::T>) -> Self

impl<T> IsPtr for Vec<T>

type T = [T]

fn into_raw_ptr(this: Self) -> NonNull<[T]>

unsafe fn from_raw_ptr(ptr: NonNull<[T]>) -> Self

impl<T: ?Sized> IsPtr for Box<T>

type T = T

fn into_raw_ptr(this: Self) -> NonNull<T>

unsafe fn from_raw_ptr(ptr: NonNull<T>) -> Self

impl<T: ?Sized> IsPtr for Arc<T>

type T = T

fn into_raw_ptr(this: Self) -> NonNull<T>

unsafe fn from_raw_ptr(ptr: NonNull<T>) -> Self

Implementors