casWeak

Stores 'writeThis' to the memory referenced by 'here' if the value referenced by 'here' is equal to the value referenced by 'ifThis'. The prior value referenced by 'here' is written to ifThis and returned to the user. The 'weak' version of cas may spuriously fail. It is recommended to use casWeak only when cas would be used in a loop. This operation is both lock-free and atomic. *

bool casWeak(T* here, V1 ifThis, V2 writeThis)
bool casWeak(shared(T)* here, V1 ifThis, V2 writeThis)
bool casWeak(shared(T)* here, shared(V1) ifThis, shared(V2) writeThis)
bool casWeak(T* here, T* ifThis, V writeThis)
pure nothrow @nogc @trusted
bool
casWeak
(
MemoryOrder succ = MemoryOrder.seq
MemoryOrder fail = MemoryOrder.seq
T
V
)
(
T* here
,
T* ifThis
,
V writeThis
)
if (
!is(T == shared S,
S
) &&
!is(V == shared U,
U
)
)
in (atomicPtrIsProperlyAligned(here), "Argument `here` is not properly aligned")
bool casWeak(shared(T)* here, V1* ifThis, V2 writeThis)
bool casWeak(shared(T)* here, shared(T)* ifThis, shared(V) writeThis)

Parameters

here: Type: T*
The address of the destination variable.
writeThis: Type: V
The value to store.
ifThis: Type: T*
The address of the value to compare, and receives the prior value of here as output. *

Return Value

Type: bool

true if the store occurred, false if not.

core atomic enums

MemoryOrder

functions