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)
pure nothrow @nogc @trusted
bool
cas
(
MemoryOrder succ = MemoryOrder.seq
MemoryOrder fail = MemoryOrder.seq
T
V1
V2
)
(
shared(T)* here
,
V1 ifThis
,
V2 writeThis
)
if (
!is(T == class) &&
(
is(T : V1) ||
is(shared T : V1)
)
)
in (atomicPtrIsProperlyAligned(here), "Argument `here` is not properly aligned")
bool cas(shared(T)* here, shared(V1) ifThis, shared(V2) writeThis)
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)
T arg2;

Parameters

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

Return Value

Type: bool

true if the store occurred, false if not.

core atomic enums

MemoryOrder

functions