[−][src]Trait core::pin::Unpin
Types which can be safely moved after being pinned.
Since Rust itself has no notion of immovable types, and will consider moves to always be safe, this trait cannot prevent types from moving by itself.
Instead it can be used to prevent moves through the type system,
by controlling the behavior of pointers wrapped in the Pin
wrapper,
which "pin" the type in place by not allowing it to be moved out of them.
See the pin module
documentation for more information on pinning.
Implementing this trait lifts the restrictions of pinning off a type,
which then allows it to move out with functions such as replace
.
So this, for example, can only be done on types implementing Unpin
:
#![feature(pin)] use std::mem::replace; use std::pin::Pin; let mut string = "this".to_string(); let mut pinned_string = Pin::new(&mut string); // dereferencing the pointer mutably is only possible because String implements Unpin replace(&mut *pinned_string, "other".to_string());Run
This trait is automatically implemented for almost every type.
Implementors
impl !Unpin for Pinned
[src]
impl !Unpin for Pinned
impl Unpin for LocalWaker
[src]
impl Unpin for LocalWaker
impl Unpin for Waker
[src]
impl Unpin for Waker
impl<'a, T: ?Sized + 'a> Unpin for &'a T
[src]
impl<'a, T: ?Sized + 'a> Unpin for &'a T
impl<'a, T: ?Sized + 'a> Unpin for &'a mut T
[src]
impl<'a, T: ?Sized + 'a> Unpin for &'a mut T
impl<P> Unpin for Pin<P>
[src]
impl<P> Unpin for Pin<P>