cas

Stores 'writeThis' to the memory referenced by 'here' if the value referenced by 'here' is equal to 'ifThis'. This operation is both lock-free and atomic.

bool cas(T* here, V1 ifThis, V2 writeThis)
bool cas(shared(T)* here, V1 ifThis, V2 writeThis)
bool cas(shared(T)* here, shared(V1) ifThis, shared(V2) writeThis)
pure nothrow @nogc @trusted
bool
cas
(
MemoryOrder succ = MemoryOrder.seq
MemoryOrder fail = MemoryOrder.seq
T
V1
V2
)
(
shared(T)* here
,
shared(V1) ifThis
,
shared(V2) writeThis
)
if (
is(T == class)
)
in (atomicPtrIsProperlyAligned(here), "Argument `here` is not properly aligned")
bool cas(T* here, T* ifThis, V writeThis)
bool cas(shared(T)* here, V1* ifThis, V2 writeThis)
bool cas(shared(T)* here, shared(T)* ifThis, shared(V) writeThis)
alias Thunk2 = V2

Parameters

here: Type: shared(T)*
The address of the destination variable.
writeThis: Type: shared(V2)
The value to store.
ifThis: Type: shared(V1)
The comparison value.

Return Value

Type: bool

true if the store occurred, false if not.

core atomic enums

MemoryOrder

functions