Trait InPlaceInit

pub trait InPlaceInit<T>: Sized {
    type PinnedSelf;

    // Required methods
    fn try_pin_init<E>(
        init: impl PinInit<T, E>,
        flags: Flags,
    ) -> Result<Self::PinnedSelf, E>
       where E: From<AllocError>;
    fn try_init<E>(init: impl Init<T, E>, flags: Flags) -> Result<Self, E>
       where E: From<AllocError>;

    // Provided methods
    fn pin_init<E>(
        init: impl PinInit<T, E>,
        flags: Flags,
    ) -> Result<Self::PinnedSelf>
       where Error: From<E> { ... }
    fn init<E>(init: impl Init<T, E>, flags: Flags) -> Result<Self>
       where Error: From<E> { ... }
}

Smart pointer that can initialize memory in-place.

Required Associated Types

type PinnedSelf

Pinned version of Self.

If a type already implicitly pins its pointee, Pin<Self> is unnecessary. In this case use Self, otherwise just use Pin<Self>.

Required Methods

fn try_pin_init<E>( init: impl PinInit<T, E>, flags: Flags, ) -> Result<Self::PinnedSelf, E>

where E: From<AllocError>,

Use the given pin-initializer to pin-initialize a T inside of a new smart pointer of this type.

If T: !Unpin it will not be able to move afterwards.

fn try_init<E>(init: impl Init<T, E>, flags: Flags) -> Result<Self, E>

where E: From<AllocError>,

Use the given initializer to in-place initialize a T.

Provided Methods

fn pin_init<E>( init: impl PinInit<T, E>, flags: Flags, ) -> Result<Self::PinnedSelf>

where Error: From<E>,

Use the given pin-initializer to pin-initialize a T inside of a new smart pointer of this type.

If T: !Unpin it will not be able to move afterwards.

fn init<E>(init: impl Init<T, E>, flags: Flags) -> Result<Self>

where Error: From<E>,

Use the given initializer to in-place initialize a T.

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.

Implementors

impl<T> InPlaceInit<T> for Arc<T>

type PinnedSelf = Arc<T>

impl<T> InPlaceInit<T> for UniqueArc<T>

type PinnedSelf = Pin<UniqueArc<T>>

impl<T, A> InPlaceInit<T> for Box<T, A>

where A: Allocator + 'static,

type PinnedSelf = Pin<Box<T, A>>