core::marker::Unpin - Rust
Description: API documentation for the Rust `Unpin` trait in crate `core`.
Keywords: rust, rustlang, rust-lang, Unpin

# 1.33.0[−][src]Trait core::marker::Unpin

    #[lang = "unpin"]pub auto trait Unpin { }

Types that can be safely moved after being pinned.

Rust itself has no notion of immovable types, and considers moves (e.g., through assignment or `mem::replace`) to always be safe.

The `Pin` type is used instead to prevent moves through the type system. Pointers `P<T>` wrapped in the `Pin<P<T>>` wrapper can't be moved out of. See the `pin` module documentation for more information on pinning.

Implementing the `Unpin` trait for `T` lifts the restrictions of pinning off the type, which then allows moving `T` out of `Pin<P<T>>` with functions such as `mem::replace`.

`Unpin` has no consequence at all for non-pinned data. In particular, `mem::replace` happily moves `!Unpin` data (it works for any `&mut T`, not just when `T: Unpin`). However, you cannot use `mem::replace` on data wrapped inside a `Pin<P<T>>` because you cannot get the `&mut T` you need for that, and that is what makes this system work.

So this, for example, can only be done on types implementing `Unpin`:

    use std::mem;
    use std::pin::Pin;

    let mut string = "this".to_string();
    let mut pinned_string = Pin::new(&mut string);

    // We need a mutable reference to call `mem::replace`.
    // We can obtain such a reference by (implicitly) invoking `Pin::deref_mut`,
    // but that is only possible because `String` implements `Unpin`.
    mem::replace(&mut *pinned_string, "other".to_string());

Run

This trait is automatically implemented for almost every type.

## Implementors

### `impl !Unpin for PhantomPinned`[src]

### `impl Unpin for Waker`[src]

### `impl<'a, T: ?Sized + 'a> Unpin for &'a T`[src]

### `impl<'a, T: ?Sized + 'a> Unpin for &'a mut T`[src]

### `impl<F> Unpin for PollFn<F>`[src]

### `impl<T> Unpin for Pending<T>`[src]

### `impl<T> Unpin for Ready<T>`[src]

### `impl<T: ?Sized> Unpin for *const T`[src]

### `impl<T: ?Sized> Unpin for *mut T`[src]

Loading content...

## Auto implementors

### `impl Unpin for core::cmp::Ordering`[src]

### `impl Unpin for Infallible`[src]

### `impl Unpin for c_void`[src]

### `impl Unpin for Alignment`[src]

### `impl Unpin for FpCategory`[src]

### `impl Unpin for IntErrorKind`[src]

### `impl Unpin for SearchStep`[src]

### `impl Unpin for core::sync::atomic::Ordering`[src]

### `impl Unpin for AllocError`[src]

### `impl Unpin for Layout`[src]

### `impl Unpin for LayoutError`[src]

### `impl Unpin for TypeId`[src]

### `impl Unpin for float64x1_t`[src]

### `impl Unpin for float64x2_t`[src]

### `impl Unpin for int8x16x2_t`[src]

### `impl Unpin for int8x16x3_t`[src]

### `impl Unpin for int8x16x4_t`[src]

### `impl Unpin for poly8x16x2_t`[src]

### `impl Unpin for poly8x16x3_t`[src]

### `impl Unpin for poly8x16x4_t`[src]

### `impl Unpin for uint8x16x2_t`[src]

### `impl Unpin for uint8x16x3_t`[src]

### `impl Unpin for uint8x16x4_t`[src]

### `impl Unpin for ISH`[src]

### `impl Unpin for ISHLD`[src]

### `impl Unpin for ISHST`[src]

### `impl Unpin for LD`[src]

### `impl Unpin for NSH`[src]

### `impl Unpin for NSHLD`[src]

### `impl Unpin for NSHST`[src]

### `impl Unpin for OSH`[src]

### `impl Unpin for OSHLD`[src]

### `impl Unpin for OSHST`[src]

### `impl Unpin for ST`[src]

### `impl Unpin for SY`[src]

### `impl Unpin for float32x2_t`[src]

### `impl Unpin for float32x4_t`[src]

### `impl Unpin for int8x8_t`[src]

### `impl Unpin for int8x8x2_t`[src]

### `impl Unpin for int8x8x3_t`[src]

### `impl Unpin for int8x8x4_t`[src]

### `impl Unpin for int8x16_t`[src]

### `impl Unpin for int16x4_t`[src]

### `impl Unpin for int16x8_t`[src]

### `impl Unpin for int32x2_t`[src]

### `impl Unpin for int32x4_t`[src]

### `impl Unpin for int64x1_t`[src]

### `impl Unpin for int64x2_t`[src]

### `impl Unpin for poly8x8_t`[src]

### `impl Unpin for poly8x8x2_t`[src]

### `impl Unpin for poly8x8x3_t`[src]

### `impl Unpin for poly8x8x4_t`[src]

### `impl Unpin for poly8x16_t`[src]

### `impl Unpin for poly16x4_t`[src]

### `impl Unpin for poly16x8_t`[src]

### `impl Unpin for poly64x1_t`[src]

### `impl Unpin for poly64x2_t`[src]

### `impl Unpin for uint8x8_t`[src]

### `impl Unpin for uint8x8x2_t`[src]

### `impl Unpin for uint8x8x3_t`[src]

### `impl Unpin for uint8x8x4_t`[src]

### `impl Unpin for uint8x16_t`[src]

### `impl Unpin for uint16x4_t`[src]

### `impl Unpin for uint16x8_t`[src]

### `impl Unpin for uint32x2_t`[src]

### `impl Unpin for uint32x4_t`[src]

### `impl Unpin for uint64x1_t`[src]

### `impl Unpin for uint64x2_t`[src]

### `impl Unpin for vector_bool_long`[src]

### `impl Unpin for vector_double`[src]

### `impl Unpin for vector_signed_long`[src]

### `impl Unpin for vector_unsigned_long`[src]

### `impl Unpin for v128`[src]

### `impl Unpin for CpuidResult`[src]

### `impl Unpin for __m128`[src]

### `impl Unpin for __m128d`[src]

### `impl Unpin for __m128i`[src]

### `impl Unpin for __m256`[src]

### `impl Unpin for __m256d`[src]

### `impl Unpin for __m256i`[src]

### `impl Unpin for __m512`[src]

### `impl Unpin for __m512d`[src]

### `impl Unpin for __m512i`[src]

### `impl Unpin for TryFromSliceError`[src]

### `impl Unpin for core::ascii::EscapeDefault`[src]

### `impl Unpin for BorrowError`[src]

### `impl Unpin for BorrowMutError`[src]

### `impl Unpin for CharTryFromError`[src]

### `impl Unpin for DecodeUtf16Error`[src]

### `impl Unpin for core::char::EscapeDebug`[src]

### `impl Unpin for core::char::EscapeDefault`[src]

### `impl Unpin for core::char::EscapeUnicode`[src]

### `impl Unpin for ParseCharError`[src]

### `impl Unpin for ToLowercase`[src]

### `impl Unpin for ToUppercase`[src]

### `impl Unpin for Error`[src]

### `impl Unpin for SipHasher`[src]

### `impl Unpin for NonZeroI8`[src]

### `impl Unpin for NonZeroI16`[src]

### `impl Unpin for NonZeroI32`[src]

### `impl Unpin for NonZeroI64`[src]

### `impl Unpin for NonZeroI128`[src]

### `impl Unpin for NonZeroIsize`[src]

### `impl Unpin for NonZeroU8`[src]

### `impl Unpin for NonZeroU16`[src]

### `impl Unpin for NonZeroU32`[src]

### `impl Unpin for NonZeroU64`[src]

### `impl Unpin for NonZeroU128`[src]

### `impl Unpin for NonZeroUsize`[src]

### `impl Unpin for ParseFloatError`[src]

### `impl Unpin for ParseIntError`[src]

### `impl Unpin for TryFromIntError`[src]

### `impl Unpin for RangeFull`[src]

### `impl Unpin for NoneError`[src]

### `impl Unpin for TraitObject`[src]

### `impl Unpin for Utf8Lossy`[src]

### `impl Unpin for ParseBoolError`[src]

### `impl Unpin for Utf8Error`[src]

### `impl Unpin for AtomicBool`[src]

### `impl Unpin for AtomicI8`[src]

### `impl Unpin for AtomicI16`[src]

### `impl Unpin for AtomicI32`[src]

### `impl Unpin for AtomicI64`[src]

### `impl Unpin for AtomicI128`[src]

### `impl Unpin for AtomicIsize`[src]

### `impl Unpin for AtomicU8`[src]

### `impl Unpin for AtomicU16`[src]

### `impl Unpin for AtomicU32`[src]

### `impl Unpin for AtomicU64`[src]

### `impl Unpin for AtomicU128`[src]

### `impl Unpin for AtomicUsize`[src]

### `impl Unpin for RawWaker`[src]

### `impl Unpin for RawWakerVTable`[src]

### `impl Unpin for Duration`[src]

### `impl<'a> Unpin for Arguments<'a>`[src]

### `impl<'a> Unpin for Formatter<'a>`[src]

### `impl<'a> Unpin for Location<'a>`[src]

### `impl<'a> Unpin for PanicInfo<'a>`[src]

### `impl<'a> Unpin for Utf8LossyChunk<'a>`[src]

### `impl<'a> Unpin for Utf8LossyChunksIter<'a>`[src]

### `impl<'a> Unpin for CharSearcher<'a>`[src]

### `impl<'a> Unpin for Bytes<'a>`[src]

### `impl<'a> Unpin for CharIndices<'a>`[src]

### `impl<'a> Unpin for Chars<'a>`[src]

### `impl<'a> Unpin for EncodeUtf16<'a>`[src]

### `impl<'a> Unpin for core::str::EscapeDebug<'a>`[src]

### `impl<'a> Unpin for core::str::EscapeDefault<'a>`[src]

### `impl<'a> Unpin for core::str::EscapeUnicode<'a>`[src]

### `impl<'a> Unpin for Lines<'a>`[src]

### `impl<'a> Unpin for LinesAny<'a>`[src]

### `impl<'a> Unpin for SplitAsciiWhitespace<'a>`[src]

### `impl<'a> Unpin for SplitWhitespace<'a>`[src]

### `impl<'a> Unpin for Context<'a>`[src]

### `impl<'a, 'b> Unpin for DebugList<'a, 'b> where
'b: 'a,` [src]

### `impl<'a, 'b> Unpin for DebugMap<'a, 'b> where
'b: 'a,` [src]

### `impl<'a, 'b> Unpin for DebugSet<'a, 'b> where
'b: 'a,` [src]

### `impl<'a, 'b> Unpin for DebugStruct<'a, 'b> where
'b: 'a,` [src]

### `impl<'a, 'b> Unpin for DebugTuple<'a, 'b> where
'b: 'a,` [src]

### `impl<'a, 'b> Unpin for CharSliceSearcher<'a, 'b>`[src]

### `impl<'a, 'b> Unpin for StrSearcher<'a, 'b>`[src]

### `impl<'a, 'f> Unpin for VaList<'a, 'f> where
'f: 'a,` [src]

### `impl<'a, A> Unpin for core::option::Iter<'a, A>`[src]

### `impl<'a, A> Unpin for core::option::IterMut<'a, A>`[src]

### `impl<'a, F> Unpin for CharPredicateSearcher<'a, F> where
F: MultiCharEq + Unpin,` [src]

### `impl<'a, P> Unpin for MatchIndices<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for Matches<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for RMatchIndices<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for RMatches<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for core::str::RSplit<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for core::str::RSplitN<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for RSplitTerminator<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for core::str::Split<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for core::str::SplitN<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, P> Unpin for SplitTerminator<'a, P> where
<P as Pattern<'a>>::Searcher: Unpin,` [src]

### `impl<'a, T> Unpin for core::result::Iter<'a, T>`[src]

### `impl<'a, T> Unpin for core::result::IterMut<'a, T>`[src]

### `impl<'a, T> Unpin for Chunks<'a, T>`[src]

### `impl<'a, T> Unpin for ChunksExact<'a, T>`[src]

### `impl<'a, T> Unpin for ChunksExactMut<'a, T>`[src]

### `impl<'a, T> Unpin for ChunksMut<'a, T>`[src]

### `impl<'a, T> Unpin for core::slice::Iter<'a, T>`[src]

### `impl<'a, T> Unpin for core::slice::IterMut<'a, T>`[src]

### `impl<'a, T> Unpin for RChunks<'a, T>`[src]

### `impl<'a, T> Unpin for RChunksExact<'a, T>`[src]

### `impl<'a, T> Unpin for RChunksExactMut<'a, T>`[src]

### `impl<'a, T> Unpin for RChunksMut<'a, T>`[src]

### `impl<'a, T> Unpin for Windows<'a, T>`[src]

### `impl<'a, T, P> Unpin for core::slice::RSplit<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for RSplitMut<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for core::slice::RSplitN<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for RSplitNMut<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for core::slice::Split<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for SplitInclusive<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for SplitInclusiveMut<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for SplitMut<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for core::slice::SplitN<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, P> Unpin for SplitNMut<'a, T, P> where
P: Unpin,` [src]

### `impl<'a, T, const N: usize> Unpin for ArrayChunks<'a, T, N>`[src]

### `impl<'a, T, const N: usize> Unpin for ArrayChunksMut<'a, T, N>`[src]

### `impl<'a, T, const N: usize> Unpin for ArrayWindows<'a, T, N>`[src]

### `impl<'b, T: ?Sized> Unpin for Ref<'b, T>`[src]

### `impl<'b, T: ?Sized> Unpin for RefMut<'b, T>`[src]

### `impl<'f> Unpin for VaListImpl<'f>`[src]

### `impl<A> Unpin for Repeat<A> where
A: Unpin,` [src]

### `impl<A> Unpin for core::option::IntoIter<A> where
A: Unpin,` [src]

### `impl<A, B> Unpin for Chain<A, B> where
A: Unpin,
B: Unpin,` [src]

### `impl<A, B> Unpin for Zip<A, B> where
A: Unpin,
B: Unpin,` [src]

### `impl<B, C> Unpin for ControlFlow<B, C> where
B: Unpin,
C: Unpin,` [src]

### `impl<F> Unpin for FromFn<F> where
F: Unpin,` [src]

### `impl<F> Unpin for OnceWith<F> where
F: Unpin,` [src]

### `impl<F> Unpin for RepeatWith<F> where
F: Unpin,` [src]

### `impl<H> Unpin for BuildHasherDefault<H> where
H: Unpin,` [src]

### `impl<I> Unpin for DecodeUtf16<I> where
I: Unpin,` [src]

### `impl<I> Unpin for Cloned<I> where
I: Unpin,` [src]

### `impl<I> Unpin for Copied<I> where
I: Unpin,` [src]

### `impl<I> Unpin for Cycle<I> where
I: Unpin,` [src]

### `impl<I> Unpin for Enumerate<I> where
I: Unpin,` [src]

### `impl<I> Unpin for Flatten<I> where
I: Unpin,
<<I as Iterator>::Item as IntoIterator>::IntoIter: Unpin,` [src]

### `impl<I> Unpin for Fuse<I> where
I: Unpin,` [src]

### `impl<I> Unpin for Peekable<I> where
I: Unpin,
<I as Iterator>::Item: Unpin,` [src]

### `impl<I> Unpin for Skip<I> where
I: Unpin,` [src]

### `impl<I> Unpin for StepBy<I> where
I: Unpin,` [src]

### `impl<I> Unpin for Take<I> where
I: Unpin,` [src]

### `impl<I, F> Unpin for FilterMap<I, F> where
F: Unpin,
I: Unpin,` [src]

### `impl<I, F> Unpin for Inspect<I, F> where
F: Unpin,
I: Unpin,` [src]

### `impl<I, F> Unpin for Map<I, F> where
F: Unpin,
I: Unpin,` [src]

### `impl<I, P> Unpin for Filter<I, P> where
I: Unpin,
P: Unpin,` [src]

### `impl<I, P> Unpin for MapWhile<I, P> where
I: Unpin,
P: Unpin,` [src]

### `impl<I, P> Unpin for SkipWhile<I, P> where
I: Unpin,
P: Unpin,` [src]

### `impl<I, P> Unpin for TakeWhile<I, P> where
I: Unpin,
P: Unpin,` [src]

### `impl<I, St, F> Unpin for Scan<I, St, F> where
F: Unpin,
I: Unpin,
St: Unpin,` [src]

### `impl<I, U, F> Unpin for FlatMap<I, U, F> where
F: Unpin,
I: Unpin,
<U as IntoIterator>::IntoIter: Unpin,` [src]

### `impl<Idx> Unpin for Range<Idx> where
Idx: Unpin,` [src]

### `impl<Idx> Unpin for RangeFrom<Idx> where
Idx: Unpin,` [src]

### `impl<Idx> Unpin for RangeInclusive<Idx> where
Idx: Unpin,` [src]

### `impl<Idx> Unpin for RangeTo<Idx> where
Idx: Unpin,` [src]

### `impl<Idx> Unpin for RangeToInclusive<Idx> where
Idx: Unpin,` [src]

### `impl<P> Unpin for Pin<P> where
P: Unpin,` [src]

### `impl<T> Unpin for Bound<T> where
T: Unpin,` [src]

### `impl<T> Unpin for Option<T> where
T: Unpin,` [src]

### `impl<T> Unpin for Poll<T> where
T: Unpin,` [src]

### `impl<T> Unpin for Reverse<T> where
T: Unpin,` [src]

### `impl<T> Unpin for Empty<T> where
T: Unpin,` [src]

### `impl<T> Unpin for Once<T> where
T: Unpin,` [src]

### `impl<T> Unpin for Rev<T> where
T: Unpin,` [src]

### `impl<T> Unpin for OnceCell<T> where
T: Unpin,` [src]

### `impl<T> Unpin for Discriminant<T> where
<T as DiscriminantKind>::Discriminant: Unpin,` [src]

### `impl<T> Unpin for Wrapping<T> where
T: Unpin,` [src]

### `impl<T> Unpin for core::result::IntoIter<T> where
T: Unpin,` [src]

### `impl<T> Unpin for AtomicPtr<T>`[src]

### `impl<T> Unpin for MaybeUninit<T> where
T: Unpin,` [src]

### `impl<T, E> Unpin for Result<T, E> where
E: Unpin,
T: Unpin,` [src]

### `impl<T, F> Unpin for Successors<T, F> where
F: Unpin,
T: Unpin,` [src]

### `impl<T, F> Unpin for Lazy<T, F> where
F: Unpin,
T: Unpin,` [src]

### `impl<T, const N: usize> Unpin for core::array::IntoIter<T, N> where
T: Unpin,` [src]

### `impl<T: ?Sized> Unpin for Cell<T> where
T: Unpin,` [src]

### `impl<T: ?Sized> Unpin for RefCell<T> where
T: Unpin,` [src]

### `impl<T: ?Sized> Unpin for UnsafeCell<T> where
T: Unpin,` [src]

### `impl<T: ?Sized> Unpin for PhantomData<T> where
T: Unpin,` [src]

### `impl<T: ?Sized> Unpin for ManuallyDrop<T> where
T: Unpin,` [src]

### `impl<T: ?Sized> Unpin for NonNull<T>`[src]

### `impl<Y, R> Unpin for GeneratorState<Y, R> where
R: Unpin,
Y: Unpin,` [src]

Loading content...