Struct std::boxed::PinBox

[+] Show declaration

[+] Expand attributes
#[repr(transparent)]
pub struct PinBox<T> where
    T: ?Sized,  { /* fields omitted */ }

🔬 This is a nightly-only experimental API. (pin #49150)

[−] Expand description

A pinned, heap allocated reference.

Methods

impl<T> PinBox<T>

[−]

pub fn new(data: T) -> PinBox<T>

[−]

🔬 This is a nightly-only experimental API. (pin #49150)

Allocate memory on the heap, move the data into it and pin it.

impl<T> PinBox<T> where     T: ?Sized,

[−]

pub fn as_pin_mut(&'a mut self) -> PinMut<'a, T>

[−]

🔬 This is a nightly-only experimental API. (pin #49150)

Get a pinned reference to the data in this PinBox.

pub unsafe fn from_raw(raw: *mut T) -> PinBox<T>

[−]

🔬 This is a nightly-only experimental API. (pin #49150)

Constructs a PinBox from a raw pointer.

After calling this function, the raw pointer is owned by the resulting PinBox. Specifically, the PinBox destructor will call the destructor of T and free the allocated memory. Since the way PinBox allocates and releases memory is unspecified, the only valid pointer to pass to this function is the one taken from another PinBox via the PinBox::into_raw function.

This function is unsafe because improper use may lead to memory problems. For example, a double-free may occur if the function is called twice on the same raw pointer.

Examples

#![feature(pin)]
use std::boxed::PinBox;
let x = PinBox::new(5);
let ptr = PinBox::into_raw(x);
let x = unsafe { PinBox::from_raw(ptr) };

pub fn into_raw(b: PinBox<T>) -> *mut T

[−]

🔬 This is a nightly-only experimental API. (pin #49150)

Consumes the PinBox, returning the wrapped raw pointer.

After calling this function, the caller is responsible for the memory previously managed by the PinBox. In particular, the caller should properly destroy T and release the memory. The proper way to do so is to convert the raw pointer back into a PinBox with the PinBox::from_raw function.

Note: this is an associated function, which means that you have to call it as PinBox::into_raw(b) instead of b.into_raw(). This is so that there is no conflict with a method on the inner type.

Examples

#![feature(pin)]
use std::boxed::PinBox;
let x = PinBox::new(5);
let ptr = PinBox::into_raw(x);

Important traits for &'a mut I

impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;impl<'a, R: Read + ?Sized> Read for &'a mut Rimpl<'a, W: Write + ?Sized> Write for &'a mut W

pub unsafe fn get_mut(this: &'a mut PinBox<T>) -> &'a mut T

[−]

🔬 This is a nightly-only experimental API. (pin #49150)

Get a mutable reference to the data inside this PinBox.

This function is unsafe. Users must guarantee that the data is never moved out of this reference.

Important traits for Box<I>

impl<I> Iterator for Box<I> where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;impl<R: Read + ?Sized> Read for Box<R>impl<W: Write + ?Sized> Write for Box<W>

pub unsafe fn unpin(this: PinBox<T>) -> Box<T>

[−]

🔬 This is a nightly-only experimental API. (pin #49150)

Convert this PinBox into an unpinned Box.

This function is unsafe. Users must guarantee that the data is never moved out of the box.

Trait Implementations

impl<T> DerefMut for PinBox<T> where     T: Unpin + ?Sized,

[+]

Important traits for &'a mut I

impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;impl<'a, R: Read + ?Sized> Read for &'a mut Rimpl<'a, W: Write + ?Sized> Write for &'a mut W

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

[−]

Mutably dereferences the value.

impl<T, U> CoerceUnsized<PinBox<U>> for PinBox<T> where     T: Unsize<U> + ?Sized,     U: ?Sized,

impl<'a, F> Future for PinBox<F> where     F: Future + ?Sized,

[+]

type Output = <F as Future>::Output

🔬 This is a nightly-only experimental API. (futures_api #50547)

futures in libcore are unstable

The result of the Future.

fn poll(     self: PinMut<PinBox<F>>,     cx: &mut Context ) -> Poll<<PinBox<F> as Future>::Output>

[−]

🔬 This is a nightly-only experimental API. (futures_api #50547)

futures in libcore are unstable

Attempt to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.

impl<T> Unpin for PinBox<T> where     T: ?Sized,

impl<F> UnsafeTask for PinBox<F> where     F: 'static + Send + Future<Output = ()>,

[+]

fn into_raw(self) -> *mut ()

[−]

🔬 This is a nightly-only experimental API. (futures_api #50547)

futures in libcore are unstable

Convert a owned instance into a (conceptually owned) void pointer.

unsafe fn poll(task: *mut (), cx: &mut Context) -> Poll<()>

[−]

🔬 This is a nightly-only experimental API. (futures_api #50547)

futures in libcore are unstable

Poll the task represented by the given void pointer.

unsafe fn drop(task: *mut ())

[−]

🔬 This is a nightly-only experimental API. (futures_api #50547)

futures in libcore are unstable

Drops the task represented by the given void pointer.

impl<T> Display for PinBox<T> where     T: Display + ?Sized,

[+]

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

[−]

Formats the value using the given formatter.

impl<T> From<PinBox<T>> for Box<T> where     T: Unpin + ?Sized,

[+]

Important traits for Box<I>

impl<I> Iterator for Box<I> where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;impl<R: Read + ?Sized> Read for Box<R>impl<W: Write + ?Sized> Write for Box<W>

fn from(pinned: PinBox<T>) -> Box<T>

[−]

Performs the conversion.

impl<T> From<Box<T>> for PinBox<T> where     T: ?Sized,

[+]

fn from(boxed: Box<T>) -> PinBox<T>

[−]

Performs the conversion.

impl<F> From<PinBox<F>> for TaskObj where     F: 'static + Send + Future<Output = ()>,

[+]

fn from(boxed: PinBox<F>) -> TaskObj

[−]

Performs the conversion.

impl<T> Pointer for PinBox<T> where     T: ?Sized,

[+]

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

[−]

Formats the value using the given formatter.

impl<T> Deref for PinBox<T> where     T: ?Sized,

[+]

type Target = T

The resulting type after dereferencing.

Important traits for &'a mut I

impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;impl<'a, R: Read + ?Sized> Read for &'a mut Rimpl<'a, W: Write + ?Sized> Write for &'a mut W

fn deref(&self) -> &T

[−]

Dereferences the value.

impl<T> Debug for PinBox<T> where     T: Debug + ?Sized,

[+]

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

[−]

Formats the value using the given formatter.