Struct emplacable::Emplacable

#[repr(transparent)]
pub struct Emplacable<T, C>where
    T: ?Sized,
    C: EmplacableFn<T>,{ /* private fields */ }

A wrapped closure that you can pass to functions like box_new_with, that describes how to write a value of type T to a caller-provided allocation. You can get a T out of an Emplacable through functions like box_new_with. Alternately, you can drop the value of type T by dropping the Emplacable. Or you can forget the value of type T with Emplacable::forget.

Implementations

impl<T, C> Emplacable<T, C>where
    T: ?Sized,
    C: EmplacableFn<T>,

pub unsafe fn from_closure(closure: C) -> Self

Create a new Emplacable from a closure. This is only useful if you are implementing a function that returns an unsized value as an Emplacable.

Safety

The closure closurse must, either diverge without returning, or, if it returns, then it must have used the emplacer to fully initalize the value.

pub fn into_closure(self) -> C

Returns the closure inside this Emplacable.

This is only useful if you are implementing a function like box_new_with.

pub fn get(self) -> Twhere
    T: Sized,

Emplaces this sized T onto the stack.

pub fn forget(self)

Runs the Emplacable closure, but doesn’t run the “inner closure”, so the value of type T is forgotten, and its destrutor is not run.

If you want to drop the T and run its destructor, drop the Emplacable instead.

pub fn unsize<U: ?Sized>(self) -> Emplacable<U, impl EmplacableFn<U>>where
    T: Sized + Unsize<U>,

Turns an emplacer for a sized type into one for an unsized type via an unsizing coercion (for example, array -> slice or concrete type -> trait object).

pub fn from_iter<I>(iter: I) -> Emplacable<[T], impl EmplacableFn<[T]>>where
    T: Sized,
    I: IntoIterator<Item = Self>,
    I::IntoIter: ExactSizeIterator,

Creates an Emplacable for a slice of values of type T out of an iterator of values of type T.

This function differs from FromIterator::from_iter in that the iterator is required to be an ExactSizeIterator. If ExactSizeIterator is incorrectly implemented, this function may panic or otherwise misbehave (but will not trigger UB).

impl<T, C> Emplacable<[T], C>where
    C: EmplacableFn<[T]>,

pub fn into_vec(self) -> Vec<T>

Turns this emplacer for a slice of Ts into an owned Vec<T>.

impl<C> Emplacable<str, C>where
    C: EmplacableFn<str>,

pub fn into_string(self) -> String

Turns this emplacer for a string slice into an owned, heap-allocated String.

Trait Implementations

impl<T, C> Drop for Emplacable<T, C>where
    T: ?Sized,
    C: EmplacableFn<T>,

fn drop(&mut self)

Runs the contained closure to completion, instructing it to drop the value of type T.

impl<T, C> Extend<Emplacable<T, C>> for Vec<T>where
    C: EmplacableFn<T>,

fn extend<I>(&mut self, iter: I)where
    I: IntoIterator<Item = Emplacable<T, C>>,

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<'s, T: Clone + 's> From<&'s [T]> for Emplacable<[T], <&'s [T] as IntoEmplacable<[T]>>::Closure>

fn from(value: &'s [T]) -> Self

Converts to this type from the input type.

impl<'s> From<&'s CStr> for Emplacable<CStr, <&'s CStr as IntoEmplacable<CStr>>::Closure>

fn from(value: &'s CStr) -> Self

Converts to this type from the input type.

impl<'s> From<&'s OsStr> for Emplacable<OsStr, <&'s OsStr as IntoEmplacable<OsStr>>::Closure>

fn from(value: &'s OsStr) -> Self

Converts to this type from the input type.

impl<'s> From<&'s Path> for Emplacable<Path, <&'s Path as IntoEmplacable<Path>>::Closure>

fn from(value: &'s Path) -> Self

Converts to this type from the input type.

impl<'s> From<&'s str> for Emplacable<str, <&'s str as IntoEmplacable<str>>::Closure>

fn from(value: &'s str) -> Self

Converts to this type from the input type.

impl<T, const N: usize, C> From<[Emplacable<T, C>; N]> for Emplacable<[T; N], <[Emplacable<T, C>; N] as IntoEmplacable<[T; N]>>::Closure>where
    C: EmplacableFn<T>,

fn from(value: [Emplacable<T, C>; N]) -> Self

Converts to this type from the input type.

impl<T, const N: usize, C> From<[Emplacable<T, C>; N]> for Emplacable<[T], <[Emplacable<T, C>; N] as IntoEmplacable<[T]>>::Closure>where
    C: EmplacableFn<T>,

fn from(value: [Emplacable<T, C>; N]) -> Self

Converts to this type from the input type.

impl<T> From<Box<T, Global>> for Emplacable<T, <Box<T> as IntoEmplacable<T>>::Closure>

fn from(value: Box<T>) -> Self

Converts to this type from the input type.

impl<T, const N: usize, C> From<Emplacable<[T; N], C>> for Emplacable<[T], <Emplacable<[T; N], C> as IntoEmplacable<[T]>>::Closure>where
    C: EmplacableFn<[T; N]>,

fn from(value: Emplacable<[T; N], C>) -> Self

Converts to this type from the input type.

impl<T, C> From<Emplacable<[T], C>> for Vec<T>where
    C: EmplacableFn<[T]>,

fn from(emplacable: Emplacable<[T], C>) -> Self

Converts to this type from the input type.

impl<T, C> From<Emplacable<T, C>> for Arc<T>where
    T: ?Sized,
    C: EmplacableFn<T>,

fn from(emplacable: Emplacable<T, C>) -> Self

Converts to this type from the input type.

impl<T, C> From<Emplacable<T, C>> for Rc<T>where
    T: ?Sized,
    C: EmplacableFn<T>,

fn from(emplacable: Emplacable<T, C>) -> Self

Converts to this type from the input type.

impl<C> From<Emplacable<str, C>> for Emplacable<[u8], <Emplacable<str, C> as IntoEmplacable<[u8]>>::Closure>where
    C: EmplacableFn<str>,

fn from(emplacable: Emplacable<str, C>) -> Self

Converts to this type from the input type.

impl<C> From<Emplacable<str, C>> for Stringwhere
    C: EmplacableFn<str>,

fn from(emplacable: Emplacable<str, C>) -> Self

Converts to this type from the input type.

impl<T> From<T> for Emplacable<T, <T as IntoEmplacable<T>>::Closure>

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T> From<Vec<T, Global>> for Emplacable<[T], <Vec<T> as IntoEmplacable<[T]>>::Closure>

fn from(value: Vec<T>) -> Self

Converts to this type from the input type.

impl<T, C> FromIterator<Emplacable<T, C>> for Vec<T>where
    C: EmplacableFn<T>,

fn from_iter<I>(iter: I) -> Selfwhere
    I: IntoIterator<Item = Emplacable<T, C>>,

Creates a value from an iterator.