atomicx

Documentation

Index

• type Value
  • func NewValue[T any]() *Value[T]
  • func NewValueOf[T any](t T) *Value[T]
  • func (v *Value[T]) CompareAndSwap(old, new T) (swapped bool)
  • func (v *Value[T]) Load() (val T)
  • func (v *Value[T]) Store(val T)
  • func (v *Value[T]) Swap(new T) (old T)

Examples

• NewValue
• NewValueOf
• Value.CompareAndSwap
• Value.Load
• Value.Store
• Value.Swap

Types

type Value

type Value[T any] struct {
	// contains filtered or unexported fields
}

Value 是对 atomic.Value 的泛型封装 相比直接使用 atomic.Value， - Load 方法大概开销多了 0.5 ns - Store 方法多了不到 2 ns - Swap 方法多了 14 ns - CompareAndSwap 在失败的情况下，会多 2 ns，成功的时候多了 0.3 ns 使用 NewValue 或者 NewValueOf 来创建实例

func NewValue

func NewValue[T any]() *Value[T]

NewValue 会创建一个 Value 对象，里面存放着 T 的零值 注意，这个零值是带了类型的零值

Example

val := NewValue[int]()
data := val.Load()
fmt.Println(data)

Output:

0

func NewValueOf

func NewValueOf[T any](t T) *Value[T]

NewValueOf 会使用传入的值来创建一个 Value 对象

Example

val := NewValueOf[int](123)
data := val.Load()
fmt.Println(data)

Output:

123

func (*Value[T]) CompareAndSwap

func (v *Value[T]) CompareAndSwap(old, new T) (swapped bool)

Example

val := NewValueOf[int](123)
swapped := val.CompareAndSwap(123, 456)
fmt.Println(swapped)

swapped = val.CompareAndSwap(455, 459)
fmt.Println(swapped)

Output:

true
false

func (*Value[T]) Load

func (v *Value[T]) Load() (val T)

Example

val := NewValueOf[int](123)
data := val.Load()
fmt.Println(data)

Output:

123

func (*Value[T]) Store

func (v *Value[T]) Store(val T)

Example

val := NewValueOf[int](123)
data := val.Load()
fmt.Println(data)
val.Store(456)
data = val.Load()
fmt.Println(data)

Output:

123
456

func (*Value[T]) Swap

func (v *Value[T]) Swap(new T) (old T)

Example

val := NewValueOf[int](123)
oldVal := val.Swap(456)
newVal := val.Load()
fmt.Printf("old: %d, new: %d", oldVal, newVal)

Output:

old: 123, new: 456