atomic
import "sync/atomic"
atomic包提供了底层的原子级内存操作,对于同步算法的实现很有用。
这些函数必须谨慎地保证正确使用。除了某些特殊的底层应用,使用通道或者sync包的函数/类型实现同步更好。
应通过通信来共享内存,而不通过共享内存实现通信。
被SwapT系列函数实现的交换操作,在原子性上等价于:
old = *addr *addr = new return old
CompareAndSwapT系列函数实现的比较-交换操作,在原子性上等价于:
if *addr == old { *addr = new return true } return false
AddT 系列函数实现加法操作,在原子性上等价于:
*addr += delta return *addr
LoadT和StoreT系列函数实现的加载和保持操作,在原子性上等价于:"return *addr"和"*addr = val"。
func LoadInt32
func LoadInt32(addr *int32) (val int32)
LoadInt32原子性的获取*addr的值。
func LoadInt64
func LoadInt64(addr *int64) (val int64)
LoadInt64原子性的获取*addr的值。
func LoadUint32
func LoadUint32(addr *uint32) (val uint32)
LoadUint32原子性的获取*addr的值。
func LoadUint64
func LoadUint64(addr *uint64) (val uint64)
LoadUint64原子性的获取*addr的值。
func LoadUintptr
func LoadUintptr(addr *uintptr) (val uintptr)
LoadUintptr原子性的获取*addr的值。
func LoadPointer
func LoadPointer(addr *unsafe.Pointer) (val unsafe.Pointer)
LoadPointer原子性的获取*addr的值。
func StoreInt32
func StoreInt32(addr *int32, val int32)
StoreInt32原子性的将val的值保存到*addr。
func StoreInt64
func StoreInt64(addr *int64, val int64)
StoreInt64原子性的将val的值保存到*addr。
func StoreUint32
func StoreUint32(addr *uint32, val uint32)
StoreUint32原子性的将val的值保存到*addr。
func StoreUint64
func StoreUint64(addr *uint64, val uint64)
StoreUint64原子性的将val的值保存到*addr。
func StoreUintptr
func StoreUintptr(addr *uintptr, val uintptr)
StoreUintptr原子性的将val的值保存到*addr。
func StorePointer
func StorePointer(addr *unsafe.Pointer, val unsafe.Pointer)
StorePointer原子性的将val的值保存到*addr。
func AddInt32
func AddInt32(addr *int32, delta int32) (new int32)
AddInt32原子性的将val的值添加到*addr并返回新值。
func AddInt64
func AddInt64(addr *int64, delta int64) (new int64)
AddInt64原子性的将val的值添加到*addr并返回新值。
func AddUint32
func AddUint32(addr *uint32, delta uint32) (new uint32)
AddUint32原子性的将val的值添加到*addr并返回新值。
如要减去一个值c,调用AddUint32(&x, ^uint32(c-1));特别的,让x减1,调用AddUint32(&x, ^uint32(0))。
func AddUint64
func AddUint64(addr *uint64, delta uint64) (new uint64)
AddUint64原子性的将val的值添加到*addr并返回新值。
如要减去一个值c,调用AddUint64(&x, ^uint64(c-1));特别的,让x减1,调用AddUint64(&x, ^uint64(0))。
func AddUintptr
func AddUintptr(addr *uintptr, delta uintptr) (new uintptr)
AddUintptr原子性的将val的值添加到*addr并返回新值。
func SwapInt32
func SwapInt32(addr *int32, new int32) (old int32)
SwapInt32原子性的将新值保存到*addr并返回旧值。
func SwapInt64
func SwapInt64(addr *int64, new int64) (old int64)
SwapInt64原子性的将新值保存到*addr并返回旧值。
func SwapUint32
func SwapUint32(addr *uint32, new uint32) (old uint32)
SwapUint32原子性的将新值保存到*addr并返回旧值。
func SwapUint64
func SwapUint64(addr *uint64, new uint64) (old uint64)
SwapUint64原子性的将新值保存到*addr并返回旧值。
func SwapUintptr
func SwapUintptr(addr *uintptr, new uintptr) (old uintptr)
SwapUintptr原子性的将新值保存到*addr并返回旧值。
func SwapPointer
func SwapPointer(addr *unsafe.Pointer, new unsafe.Pointer) (old unsafe.Pointer)
SwapPointer原子性的将新值保存到*addr并返回旧值。
func CompareAndSwapInt32
func CompareAndSwapInt32(addr *int32, old, new int32) (swapped bool)
CompareAndSwapInt32原子性的比较*addr和old,如果相同则将new赋值给*addr并返回真。
func CompareAndSwapInt64
func CompareAndSwapInt64(addr *int64, old, new int64) (swapped bool)
CompareAndSwapInt64原子性的比较*addr和old,如果相同则将new赋值给*addr并返回真。
func CompareAndSwapUint32
func CompareAndSwapUint32(addr *uint32, old, new uint32) (swapped bool)
CompareAndSwapUint32原子性的比较*addr和old,如果相同则将new赋值给*addr并返回真。
func CompareAndSwapUint64
func CompareAndSwapUint64(addr *uint64, old, new uint64) (swapped bool)
CompareAndSwapUint64原子性的比较*addr和old,如果相同则将new赋值给*addr并返回真。
func CompareAndSwapUintptr
func CompareAndSwapUintptr(addr *uintptr, old, new uintptr) (swapped bool)
CompareAndSwapUintptr原子性的比较*addr和old,如果相同则将new赋值给*addr并返回真。
func CompareAndSwapPointer
func CompareAndSwapPointer(addr *unsafe.Pointer, old, new unsafe.Pointer) (swapped bool)
CompareAndSwapPointer原子性的比较*addr和old,如果相同则将new赋值给*addr并返回真。
Bugs
☞ 在x86-32构架芯片上,64位函数使用的指令在Pentium MMX之前是不可用的;在非Linux的ARM芯片上,64位函数使用的指令在ARMv6k core之前是不可用的。不管是ARM又或x86-32芯片,安排原子性访问的64位word的64位对齐都是调用者的责任。可以依靠全局变量或申请的切片/结构体的第一个word来实现64位对齐。