1.0.0[][src]Trait wasmer_types::entity::__core::prelude::v1::Sync

#[lang = "sync"]pub unsafe auto trait Sync { }

Types for which it is safe to share references between threads.

This trait is automatically implemented when the compiler determines it's appropriate.

The precise definition is: a type T is Sync if and only if &T is Send. In other words, if there is no possibility of undefined behavior (including data races) when passing &T references between threads.

As one would expect, primitive types like u8 and f64 are all Sync, and so are simple aggregate types containing them, like tuples, structs and enums. More examples of basic Sync types include "immutable" types like &T, and those with simple inherited mutability, such as Box<T>, Vec<T> and most other collection types. (Generic parameters need to be Sync for their container to be Sync.)

A somewhat surprising consequence of the definition is that &mut T is Sync (if T is Sync) even though it seems like that might provide unsynchronized mutation. The trick is that a mutable reference behind a shared reference (that is, & &mut T) becomes read-only, as if it were a & &T. Hence there is no risk of a data race.

Types that are not Sync are those that have "interior mutability" in a non-thread-safe form, such as Cell and RefCell. These types allow for mutation of their contents even through an immutable, shared reference. For example the set method on Cell<T> takes &self, so it requires only a shared reference &Cell<T>. The method performs no synchronization, thus Cell cannot be Sync.

Another example of a non-Sync type is the reference-counting pointer Rc. Given any reference &Rc<T>, you can clone a new Rc<T>, modifying the reference counts in a non-atomic way.

For cases when one does need thread-safe interior mutability, Rust provides atomic data types, as well as explicit locking via sync::Mutex and sync::RwLock. These types ensure that any mutation cannot cause data races, hence the types are Sync. Likewise, sync::Arc provides a thread-safe analogue of Rc.

Any types with interior mutability must also use the cell::UnsafeCell wrapper around the value(s) which can be mutated through a shared reference. Failing to doing this is undefined behavior. For example, transmute-ing from &T to &mut T is invalid.

See the Nomicon for more details about Sync.

Implementations on Foreign Types

impl<'a, B: ?Sized> Sync for Cow<'a, B> where
    B: Sync,
    <B as ToOwned>::Owned: Sync

impl<T: ?Sized> Sync for Box<T> where
    T: Sync

impl Sync for Argument

impl Sync for FormatSpec

impl Sync for Alignment

impl Sync for Count

impl Sync for String

impl Sync for FromUtf8Error

impl Sync for FromUtf16Error

impl<'a, T> !Sync for Iter<'a, T>

impl<'a, T> !Sync for TryIter<'a, T>

impl<T> !Sync for IntoIter<T>

impl<T> Sync for SyncSender<T> where
    T: Send

impl<T> Sync for SendError<T> where
    T: Sync

impl Sync for RecvError

impl Sync for TryRecvError

impl Sync for RecvTimeoutError

impl<T> Sync for TrySendError<T> where
    T: Sync

impl Sync for Barrier

impl Sync for BarrierWaitResult

impl Sync for Condvar

impl Sync for WaitTimeoutResult

impl !Sync for OnceState

impl<T> Sync for PoisonError<T> where
    T: Sync

impl<T> Sync for TryLockError<T> where
    T: Sync

impl<T> Sync for Vec<T> where
    T: Sync

impl<'a, I> Sync for Splice<'a, I> where
    I: Sync,
    <I as Iterator>::Item: Sync

impl<'a, T, F> Sync for DrainFilter<'a, T, F> where
    F: Sync,
    T: Sync

impl Sync for Big32x40

impl Sync for Big8x3

impl Sync for Sign

impl<'a> Sync for Decimal<'a>

impl<'a> Sync for ParseResult<'a>

impl Sync for Unpacked

impl Sync for Decoded

impl Sync for FullDecoded

impl<'a> Sync for Part<'a>

impl<'a> Sync for Formatted<'a>

impl Sync for Sign

impl !Sync for Args[src]

impl<'a> Sync for IoSliceMut<'a>[src]

impl<'_, T> Sync for RwLockReadGuard<'_, T> where
    T: Sync + ?Sized
[src]

impl<'_, T> Sync for MutexGuard<'_, T> where
    T: Sync + ?Sized
[src]

impl<T> !Sync for Sender<T>[src]

impl<'a> Sync for IoSlice<'a>[src]

impl<T> Sync for SyncOnceCell<T> where
    T: Send + Sync
[src]

impl<T> Sync for JoinHandle<T>[src]

impl<T, F> Sync for SyncLazy<T, F> where
    F: Send,
    SyncOnceCell<T>: Sync
[src]

impl<'_, T> Sync for RwLockWriteGuard<'_, T> where
    T: Sync + ?Sized
[src]

impl<T> Sync for RwLock<T> where
    T: Send + Sync + ?Sized
[src]

impl<T> Sync for Mutex<T> where
    T: Send + ?Sized
[src]

impl<T> Sync for Key<T>[src]

impl<T> !Sync for Receiver<T>[src]

impl Sync for Once[src]

impl !Sync for ArgsOs[src]

impl<T> !Sync for *mut T where
    T: ?Sized
[src]

impl<T> !Sync for *const T where
    T: ?Sized
[src]

impl<T> Sync for Weak<T> where
    T: Send + Sync + ?Sized
[src]

impl<'_, T> Sync for Drain<'_, T> where
    T: Sync
[src]

impl<T> !Sync for Weak<T> where
    T: ?Sized
[src]

impl<T> Sync for IntoIter<T> where
    T: Sync
[src]

impl<'_, T> Sync for IterMut<'_, T> where
    T: Sync
[src]

impl<'_> Sync for Drain<'_>[src]

impl<T> Sync for Arc<T> where
    T: Send + Sync + ?Sized
[src]

impl<'_, T> Sync for Drain<'_, T> where
    T: Sync
[src]

impl<'_, T> Sync for Cursor<'_, T> where
    T: Sync
[src]

impl<'_, T> Sync for CursorMut<'_, T> where
    T: Sync
[src]

impl<T> Sync for LinkedList<T> where
    T: Sync
[src]

impl<T> !Sync for Rc<T> where
    T: ?Sized
[src]

impl<'_, T> Sync for Iter<'_, T> where
    T: Sync
[src]

impl<'_, K, V> Sync for RustcOccupiedEntry<'_, K, V> where
    K: Sync,
    V: Sync

impl<'_, K, V, S> Sync for RawOccupiedEntryMut<'_, K, V, S> where
    K: Sync,
    S: Sync,
    V: Sync

impl<'_, K, V, S> Sync for OccupiedEntry<'_, K, V, S> where
    K: Sync,
    S: Sync,
    V: Sync

impl Sync for isize

impl<T> Sync for [T] where
    T: Sync

impl Sync for [u8]

impl Sync for char

impl Sync for u128

impl Sync for u16

impl Sync for i128

impl Sync for i16

impl Sync for str

impl Sync for f64

impl Sync for u64

impl Sync for u8

impl Sync for i64

impl Sync for i8

impl<T, const N: usize> Sync for [T; N] where
    T: Sync

impl Sync for bool

impl Sync for f32

impl Sync for u32

impl Sync for usize

impl Sync for i32

Loading content...

Implementors

impl Sync for AtomicBool[src]

impl Sync for AtomicI8[src]

impl Sync for AtomicI16[src]

impl Sync for AtomicI32[src]

impl Sync for AtomicI64[src]

impl Sync for AtomicI128[src]

impl Sync for AtomicIsize[src]

impl Sync for AtomicU8[src]

impl Sync for AtomicU16[src]

impl Sync for AtomicU32[src]

impl Sync for AtomicU64[src]

impl Sync for AtomicU128[src]

impl Sync for AtomicUsize[src]

impl Sync for Waker[src]

impl<'_, T> Sync for wasmer_types::entity::__core::slice::Iter<'_, T> where
    T: Sync
[src]

impl<'_, T> Sync for wasmer_types::entity::__core::slice::IterMut<'_, T> where
    T: Sync
[src]

impl<T> !Sync for Cell<T> where
    T: ?Sized
[src]

impl<T> !Sync for RefCell<T> where
    T: ?Sized
[src]

impl<T> !Sync for UnsafeCell<T> where
    T: ?Sized
[src]

impl<T> !Sync for NonNull<T> where
    T: ?Sized
[src]

NonNull pointers are not Sync because the data they reference may be aliased.

impl<T> Sync for Empty<T>[src]

impl<T> Sync for AtomicPtr<T>[src]

Loading content...

Auto implementors

impl !Sync for ExternRef

impl !Sync for TraitObject

impl !Sync for RawWaker

impl Sync for wasmer_types::entity::__core::cmp::Ordering

impl Sync for Infallible

impl Sync for c_void

impl Sync for wasmer_types::entity::__core::fmt::Alignment

impl Sync for FpCategory

impl Sync for IntErrorKind

impl Sync for SearchStep

impl Sync for wasmer_types::entity::__core::sync::atomic::Ordering

impl Sync for ExportIndex

impl Sync for ExternType

impl Sync for GlobalInit

impl Sync for ImportIndex

impl Sync for Mutability

impl Sync for Type

impl Sync for AllocErr

impl Sync for Layout

impl Sync for LayoutErr

impl Sync for TypeId

impl Sync for CpuidResult

impl Sync for __m64

impl Sync for __m128

impl Sync for __m128d

impl Sync for __m128i

impl Sync for __m256

impl Sync for __m256d

impl Sync for __m256i

impl Sync for __m512

impl Sync for __m512d

impl Sync for __m512i

impl Sync for TryFromSliceError

impl Sync for wasmer_types::entity::__core::ascii::EscapeDefault

impl Sync for BorrowError

impl Sync for BorrowMutError

impl Sync for CharTryFromError

impl Sync for DecodeUtf16Error

impl Sync for wasmer_types::entity::__core::char::EscapeDebug

impl Sync for wasmer_types::entity::__core::char::EscapeDefault

impl Sync for wasmer_types::entity::__core::char::EscapeUnicode

impl Sync for ParseCharError

impl Sync for ToLowercase

impl Sync for ToUppercase

impl Sync for Error

impl Sync for SipHasher

impl Sync for PhantomPinned

impl Sync for NonZeroI8

impl Sync for NonZeroI16

impl Sync for NonZeroI32

impl Sync for NonZeroI64

impl Sync for NonZeroI128

impl Sync for NonZeroIsize

impl Sync for NonZeroU8

impl Sync for NonZeroU16

impl Sync for NonZeroU32

impl Sync for NonZeroU64

impl Sync for NonZeroU128

impl Sync for NonZeroUsize

impl Sync for ParseFloatError

impl Sync for ParseIntError

impl Sync for TryFromIntError

impl Sync for RangeFull

impl Sync for NoneError

impl Sync for Utf8Lossy

impl Sync for ParseBoolError

impl Sync for Utf8Error

impl Sync for RawWakerVTable

impl Sync for Duration

impl Sync for Atomically

impl Sync for wasmer_types::Bytes

impl Sync for CustomSectionIndex

impl Sync for DataIndex

impl Sync for DataInitializerLocation

impl Sync for ElemIndex

impl Sync for Features

impl Sync for FunctionIndex

impl Sync for FunctionType

impl Sync for GlobalIndex

impl Sync for GlobalType

impl Sync for LocalFunctionIndex

impl Sync for LocalGlobalIndex

impl Sync for LocalMemoryIndex

impl Sync for LocalTableIndex

impl Sync for MemoryIndex

impl Sync for MemoryType

impl Sync for OwnedDataInitializer

impl Sync for Pages

impl Sync for SignatureIndex

impl Sync for TableIndex

impl Sync for TableInitializer

impl Sync for TableType

impl Sync for V128

impl<'a> !Sync for Arguments<'a>

impl<'a> !Sync for Formatter<'a>

impl<'a> !Sync for PanicInfo<'a>

impl<'a> Sync for Location<'a>

impl<'a> Sync for Utf8LossyChunk<'a>

impl<'a> Sync for Utf8LossyChunksIter<'a>

impl<'a> Sync for CharSearcher<'a>

impl<'a> Sync for wasmer_types::entity::__core::str::Bytes<'a>

impl<'a> Sync for CharIndices<'a>

impl<'a> Sync for Chars<'a>

impl<'a> Sync for EncodeUtf16<'a>

impl<'a> Sync for wasmer_types::entity::__core::str::EscapeDebug<'a>

impl<'a> Sync for wasmer_types::entity::__core::str::EscapeDefault<'a>

impl<'a> Sync for wasmer_types::entity::__core::str::EscapeUnicode<'a>

impl<'a> Sync for Lines<'a>

impl<'a> Sync for LinesAny<'a>

impl<'a> Sync for SplitAsciiWhitespace<'a>

impl<'a> Sync for SplitWhitespace<'a>

impl<'a> Sync for Context<'a>

impl<'a, 'b> !Sync for DebugList<'a, 'b>

impl<'a, 'b> !Sync for DebugMap<'a, 'b>

impl<'a, 'b> !Sync for DebugSet<'a, 'b>

impl<'a, 'b> !Sync for DebugStruct<'a, 'b>

impl<'a, 'b> !Sync for DebugTuple<'a, 'b>

impl<'a, 'b> Sync for CharSliceSearcher<'a, 'b>

impl<'a, 'b> Sync for StrSearcher<'a, 'b>

impl<'a, 'f> !Sync for VaList<'a, 'f>

impl<'a, A> Sync for wasmer_types::entity::__core::option::Iter<'a, A> where
    A: Sync

impl<'a, A> Sync for wasmer_types::entity::__core::option::IterMut<'a, A> where
    A: Sync

impl<'a, F> Sync for CharPredicateSearcher<'a, F> where
    F: MultiCharEq + Sync

impl<'a, K, V> Sync for wasmer_types::entity::Iter<'a, K, V> where
    K: Sync,
    V: Sync

impl<'a, K, V> Sync for wasmer_types::entity::IterMut<'a, K, V> where
    K: Sync,
    V: Sync

impl<'a, P> Sync for MatchIndices<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for Matches<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for RMatchIndices<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for RMatches<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for wasmer_types::entity::__core::str::RSplit<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for wasmer_types::entity::__core::str::RSplitN<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for RSplitTerminator<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for wasmer_types::entity::__core::str::Split<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for wasmer_types::entity::__core::str::SplitInclusive<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for wasmer_types::entity::__core::str::SplitN<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, P> Sync for SplitTerminator<'a, P> where
    <P as Pattern<'a>>::Searcher: Sync

impl<'a, T> Sync for wasmer_types::entity::__core::result::Iter<'a, T> where
    T: Sync

impl<'a, T> Sync for wasmer_types::entity::__core::result::IterMut<'a, T> where
    T: Sync

impl<'a, T> Sync for Chunks<'a, T> where
    T: Sync

impl<'a, T> Sync for ChunksExact<'a, T> where
    T: Sync

impl<'a, T> Sync for ChunksExactMut<'a, T> where
    T: Sync

impl<'a, T> Sync for ChunksMut<'a, T> where
    T: Sync

impl<'a, T> Sync for RChunks<'a, T> where
    T: Sync

impl<'a, T> Sync for RChunksExact<'a, T> where
    T: Sync

impl<'a, T> Sync for RChunksExactMut<'a, T> where
    T: Sync

impl<'a, T> Sync for RChunksMut<'a, T> where
    T: Sync

impl<'a, T> Sync for Windows<'a, T> where
    T: Sync

impl<'a, T, A = NonAtomically> !Sync for MemoryView<'a, T, A>

impl<'a, T, P> Sync for wasmer_types::entity::__core::slice::RSplit<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for RSplitMut<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for wasmer_types::entity::__core::slice::RSplitN<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for RSplitNMut<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for wasmer_types::entity::__core::slice::Split<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for wasmer_types::entity::__core::slice::SplitInclusive<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for SplitInclusiveMut<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for SplitMut<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for wasmer_types::entity::__core::slice::SplitN<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, P> Sync for SplitNMut<'a, T, P> where
    P: Sync,
    T: Sync

impl<'a, T, const N: usize> Sync for ArrayChunks<'a, T, N> where
    T: Sync

impl<'a, T, const N: usize> Sync for ArrayChunksMut<'a, T, N> where
    T: Sync

impl<'b, T> !Sync for Ref<'b, T>

impl<'b, T> !Sync for RefMut<'b, T>

impl<'data> Sync for DataInitializer<'data>

impl<'f> !Sync for VaListImpl<'f>

impl<A> Sync for Repeat<A> where
    A: Sync

impl<A> Sync for wasmer_types::entity::__core::option::IntoIter<A> where
    A: Sync

impl<A, B> Sync for Chain<A, B> where
    A: Sync,
    B: Sync

impl<A, B> Sync for Zip<A, B> where
    A: Sync,
    B: Sync

impl<C, B> Sync for ControlFlow<C, B> where
    B: Sync,
    C: Sync

impl<F> Sync for PollFn<F> where
    F: Sync

impl<F> Sync for FromFn<F> where
    F: Sync

impl<F> Sync for OnceWith<F> where
    F: Sync

impl<F> Sync for RepeatWith<F> where
    F: Sync

impl<H> Sync for BuildHasherDefault<H> where
    H: Sync

impl<I> Sync for DecodeUtf16<I> where
    I: Sync

impl<I> Sync for Cloned<I> where
    I: Sync

impl<I> Sync for Copied<I> where
    I: Sync

impl<I> Sync for Cycle<I> where
    I: Sync

impl<I> Sync for Enumerate<I> where
    I: Sync

impl<I> Sync for Flatten<I> where
    I: Sync,
    <<I as Iterator>::Item as IntoIterator>::IntoIter: Sync

impl<I> Sync for Fuse<I> where
    I: Sync

impl<I> Sync for Peekable<I> where
    I: Sync,
    <I as Iterator>::Item: Sync

impl<I> Sync for Skip<I> where
    I: Sync

impl<I> Sync for StepBy<I> where
    I: Sync

impl<I> Sync for Take<I> where
    I: Sync

impl<I, F> Sync for FilterMap<I, F> where
    F: Sync,
    I: Sync

impl<I, F> Sync for Inspect<I, F> where
    F: Sync,
    I: Sync

impl<I, F> Sync for Map<I, F> where
    F: Sync,
    I: Sync

impl<I, P> Sync for Filter<I, P> where
    I: Sync,
    P: Sync

impl<I, P> Sync for MapWhile<I, P> where
    I: Sync,
    P: Sync

impl<I, P> Sync for SkipWhile<I, P> where
    I: Sync,
    P: Sync

impl<I, P> Sync for TakeWhile<I, P> where
    I: Sync,
    P: Sync

impl<I, St, F> Sync for Scan<I, St, F> where
    F: Sync,
    I: Sync,
    St: Sync

impl<I, U, F> Sync for FlatMap<I, U, F> where
    F: Sync,
    I: Sync,
    <U as IntoIterator>::IntoIter: Sync

impl<Idx> Sync for Range<Idx> where
    Idx: Sync

impl<Idx> Sync for RangeFrom<Idx> where
    Idx: Sync

impl<Idx> Sync for RangeInclusive<Idx> where
    Idx: Sync

impl<Idx> Sync for RangeTo<Idx> where
    Idx: Sync

impl<Idx> Sync for RangeToInclusive<Idx> where
    Idx: Sync

impl<K> Sync for EntitySet<K> where
    K: Sync

impl<K> Sync for Keys<K> where
    K: Sync

impl<K, V> Sync for BoxedSlice<K, V> where
    K: Sync,
    V: Sync

impl<K, V> Sync for PrimaryMap<K, V> where
    K: Sync,
    V: Sync

impl<K, V> Sync for SecondaryMap<K, V> where
    K: Sync,
    V: Sync

impl<K, V> Sync for SparseMap<K, V> where
    K: Sync,
    V: Sync

impl<P> Sync for Pin<P> where
    P: Sync

impl<T> !Sync for Value<T>

impl<T> !Sync for OnceCell<T>

impl<T> !Sync for HostRef<T>

impl<T> Sync for Bound<T> where
    T: Sync

impl<T> Sync for Option<T> where
    T: Sync

impl<T> Sync for Poll<T> where
    T: Sync

impl<T> Sync for Reverse<T> where
    T: Sync

impl<T> Sync for Pending<T> where
    T: Sync

impl<T> Sync for Ready<T> where
    T: Sync

impl<T> Sync for wasmer_types::entity::__core::iter::Once<T> where
    T: Sync

impl<T> Sync for Rev<T> where
    T: Sync

impl<T> Sync for Discriminant<T> where
    <T as DiscriminantKind>::Discriminant: Sync

impl<T> Sync for Wrapping<T> where
    T: Sync

impl<T> Sync for wasmer_types::entity::__core::result::IntoIter<T> where
    T: Sync

impl<T> Sync for PackedOption<T> where
    T: Sync

impl<T> Sync for EntityList<T> where
    T: Sync

impl<T> Sync for ListPool<T> where
    T: Sync

impl<T> Sync for ExportType<T> where
    T: Sync

impl<T> Sync for ImportType<T> where
    T: Sync

impl<T> Sync for MaybeUninit<T> where
    T: Sync

impl<T, E> Sync for Result<T, E> where
    E: Sync,
    T: Sync

impl<T, F> Sync for Successors<T, F> where
    F: Sync,
    T: Sync

impl<T, F = fn() -> T> !Sync for Lazy<T, F>

impl<T, const N: usize> Sync for wasmer_types::entity::__core::array::IntoIter<T, N> where
    T: Sync

impl<T: ?Sized> Sync for PhantomData<T> where
    T: Sync

impl<T: ?Sized> Sync for ManuallyDrop<T> where
    T: Sync

impl<Y, R> Sync for GeneratorState<Y, R> where
    R: Sync,
    Y: Sync

Loading content...