pub trait AtomicSwap: AtomicLoad + AtomicStore {
// Required method
unsafe fn atomic_swap(
dst: *mut MaybeUninit<Self>,
val: MaybeUninit<Self>,
order: Ordering,
) -> MaybeUninit<Self>;
}Expand description
Atomic swap.
This trait is sealed and cannot be implemented for types outside of atomic-maybe-uninit.
Required Methods§
Sourceunsafe fn atomic_swap(
dst: *mut MaybeUninit<Self>,
val: MaybeUninit<Self>,
order: Ordering,
) -> MaybeUninit<Self>
unsafe fn atomic_swap( dst: *mut MaybeUninit<Self>, val: MaybeUninit<Self>, order: Ordering, ) -> MaybeUninit<Self>
Stores a value into dst, returning the previous value.
atomic_swap takes an Ordering argument which describes the memory ordering
of this operation. All ordering modes are possible. Note that using
Acquire makes the store part of this operation Relaxed, and
using Release makes the load part Relaxed.
§Safety
Behavior is undefined if any of the following conditions are violated:
dstmust be valid for both reads and writes.dstmust be properly aligned to the size ofSelf. (For example, ifSelfisu128,dstmust be aligned to 16-byte even if the alignment ofu128is 8-byte.)ordermust beSeqCst,AcqRel,Acquire,Release, orRelaxed.
The rules for the validity of the pointer follow the rules applied to
functions exposed by the standard library’s ptr module,
except that concurrent atomic operations on dst are allowed if the
pointer go through UnsafeCell::get.
Dyn Compatibility§
This trait is not dyn compatible.
In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.