core.atomic.casWeak - multiple declarations
Function casWeak
Stores 'writeThis' to the memory referenced by 'here' if the value
referenced by 'here' is equal to 'ifThis'.
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(MemoryOrder succ = MemoryOrder
T* here,
V1 ifThis,
V2 writeThis
) pure nothrow @nogc @trusted
if (!is(T == shared) && is(T : V1));
bool casWeak(MemoryOrder succ = MemoryOrder
shared(T)* here,
V1 ifThis,
V2 writeThis
) pure nothrow @nogc @trusted
if (!is(T == class) && (is(T : V1) || is(shared(T) : V1)));
bool casWeak(MemoryOrder succ = MemoryOrder
shared(T)* here,
shared(V1) ifThis,
shared(V2) writeThis
) pure nothrow @nogc @trusted
if (is(T == class));
Parameters
| Name | Description |
|---|---|
| here | The address of the destination variable. |
| writeThis | The value to store. |
| ifThis | The comparison value. |
Returns
true if the store occurred, false if not.
Function 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(MemoryOrder succ = MemoryOrder
T* here,
T* ifThis,
V writeThis
) pure nothrow @nogc @trusted
if (!is(T == shared(S), S) && !is(V == shared(U), U));
bool casWeak(MemoryOrder succ = MemoryOrder
shared(T)* here,
V1* ifThis,
V2 writeThis
) pure nothrow @nogc @trusted
if (!is(T == class) && (is(T : V1) || is(shared(T) : V1)));
bool casWeak(MemoryOrder succ = MemoryOrder
shared(T)* here,
shared(T)* ifThis,
shared(V) writeThis
) pure nothrow @nogc @trusted
if (is(T == class));
Parameters
| Name | Description |
|---|---|
| here | The address of the destination variable. |
| writeThis | The value to store. |
| ifThis | The address of the value to compare, and receives the prior value of here as output. |
Returns
true if the store occurred, false if not.
Authors
Sean Kelly, Alex Rønne Petersen, Manu Evans