View source code
Display the source code in core/atomic.d from which this page was generated on github.
Report a bug
If you spot a problem with this page, click here to create a Bugzilla issue.
Improve this page
Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Module core.atomic

The atomic module provides basic support for lock-free concurrent programming.

Functions

NameDescription
atomicExchange(here, exchangeWith) Exchange exchangeWith with the memory referenced by here. This operation is both lock-free and atomic.
atomicExchange(here, exchangeWith) Exchange exchangeWith with the memory referenced by here. This operation is both lock-free and atomic.
atomicFence() Inserts a full load/store memory fence (on platforms that need it). This ensures that all loads and stores before a call to this function are executed before any loads and stores after the call.
atomicFence() Inserts a full load/store memory fence (on platforms that need it). This ensures that all loads and stores before a call to this function are executed before any loads and stores after the call.
atomicLoad(val) Loads 'val' from memory and returns it. The memory barrier specified by 'ms' is applied to the operation, which is fully sequenced by default. Valid memory orders are MemoryOrder.raw, MemoryOrder.acq, and MemoryOrder.seq.
atomicLoad(val) Loads 'val' from memory and returns it. The memory barrier specified by 'ms' is applied to the operation, which is fully sequenced by default. Valid memory orders are MemoryOrder.raw, MemoryOrder.acq, and MemoryOrder.seq.
atomicOp(val, mod) Performs the binary operation 'op' on val using 'mod' as the modifier.
atomicOp(val, mod) Performs the binary operation 'op' on val using 'mod' as the modifier.
atomicStore(val, newval) Writes 'newval' into 'val'. The memory barrier specified by 'ms' is applied to the operation, which is fully sequenced by default. Valid memory orders are MemoryOrder.raw, MemoryOrder.rel, and MemoryOrder.seq.
atomicStore(val, newval) Writes 'newval' into 'val'. The memory barrier specified by 'ms' is applied to the operation, which is fully sequenced by default. Valid memory orders are MemoryOrder.raw, MemoryOrder.rel, and MemoryOrder.seq.
cas(here, ifThis, writeThis) 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.
cas(here, ifThis, writeThis) 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. This operation is both lock-free and atomic.
cas(here, ifThis, writeThis) 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.
cas(here, ifThis, writeThis) 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. This operation is both lock-free and atomic.
testCAS(val)
testLoadStore(val)
testType(val)
testXCHG(val)

Enums

NameDescription
MemoryOrder Specifies the memory ordering semantics of an atomic operation.
MemoryOrder Specifies the memory ordering semantics of an atomic operation.

Authors

Sean Kelly, Alex Rønne Petersen, Manu Evans

License

Boost License 1.0