dmd ~master (2023-11-01T14:17:50Z)

casWeak

core atomic

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.

  1. bool casWeak(T* here, V1 ifThis, V2 writeThis)
  2. bool casWeak(shared(T)* here, V1 ifThis, V2 writeThis)
  3. bool casWeak(shared(T)* here, shared(V1) ifThis, shared(V2) writeThis)
  4. 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
    )
    )
  5. bool casWeak(shared(T)* here, V1* ifThis, V2 writeThis)
  6. bool casWeak(shared(T)* here, shared(T)* ifThis, shared(V) writeThis)

Parameters

here T*

The address of the destination variable.

writeThis V

The value to store.

ifThis 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.

Meta

Source

See Implementation

core atomic enumsfunctionstemplates

Page generated by adrdox