Stores a value if the current value is the same as the old value, with the returned T being the previous value and the returned bool being whether the exchange was successful. T must be an integer or pointer type. The comparison may spuriously fail.

Safety

• If T is an integer type, this is equivalent to Atomic<T>::from_ptr followed by Atomic<T>::compare_exchange_weak. Refer to the documentation of Atomic<T>::from_ptr for safety requirements.

• If T is a pointer type, this is equivalent to AtomicPtr<P>::from_ptr followed by AtomicPtr<P>::compare_exchange_weak, where P is the pointee type of the pointer. Refer to the documentation of AtomicPtr<P>::from_ptr for safety requirements.

The stabilized version of this intrinsic is available on the atomic types via the compare_exchange_weak method. For example, AtomicBool::compare_exchange_weak.