Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

atomic

package module

Go to main page

Versions in this module

v1

v1.1.0

Jun 29, 2026

Changes in this version

+ const CacheLineSize

+ func Zero[T any]() T

+ type PaddedBool struct

+ type PaddedInt32 struct

+ type PaddedInt64 struct

+ type PaddedUint32 struct

+ type PaddedUint64 struct

v1.0.0

Jan 10, 2026

Changes in this version

+ type Atomic struct

+ func NewAtomic[T any](value T) *Atomic[T]

+ func (a *Atomic[T]) Get() T

+ func (a *Atomic[T]) Load() T

+ func (a *Atomic[T]) MarshalJSON() ([]byte, error)

+ func (a *Atomic[T]) Set(value T)

+ func (a *Atomic[T]) Store(value T)

+ func (a *Atomic[T]) Swap(value T) T

+ func (a *Atomic[T]) UnmarshalJSON(b []byte) error

+ type Bool struct

+ func NewBool(val bool) *Bool

+ func (b *Bool) String() string

+ func (b *Bool) Toggle() (old bool)

+ func (x *Bool) CAS(old, new bool) (swapped bool)

+ func (x *Bool) CompareAndSwap(old, new bool) (swapped bool)

+ func (x *Bool) Load() bool

+ func (x *Bool) MarshalJSON() ([]byte, error)

+ func (x *Bool) Store(val bool)

+ func (x *Bool) Swap(val bool) (old bool)

+ func (x *Bool) UnmarshalJSON(b []byte) error

+ type Duration struct

+ func NewDuration(val time.Duration) *Duration

+ func (d *Duration) Add(delta time.Duration) time.Duration

+ func (d *Duration) String() string

+ func (d *Duration) Sub(delta time.Duration) time.Duration

+ func (x *Duration) CAS(old, new time.Duration) (swapped bool)

+ func (x *Duration) CompareAndSwap(old, new time.Duration) (swapped bool)

+ func (x *Duration) Load() time.Duration

+ func (x *Duration) MarshalJSON() ([]byte, error)

+ func (x *Duration) Store(val time.Duration)

+ func (x *Duration) Swap(val time.Duration) (old time.Duration)

+ func (x *Duration) UnmarshalJSON(b []byte) error

+ type Error struct

+ func NewError(val error) *Error

+ func (x *Error) CompareAndSwap(old, new error) (swapped bool)

+ func (x *Error) Load() error

+ func (x *Error) Store(val error)

+ func (x *Error) Swap(val error) (old error)

+ type Float32 struct

+ func NewFloat32(val float32) *Float32

+ func (f *Float32) Add(delta float32) float32

+ func (f *Float32) CAS(old, new float32) (swapped bool)

+ func (f *Float32) CompareAndSwap(old, new float32) (swapped bool)

+ func (f *Float32) String() string

+ func (f *Float32) Sub(delta float32) float32

+ func (x *Float32) Load() float32

+ func (x *Float32) MarshalJSON() ([]byte, error)

+ func (x *Float32) Store(val float32)

+ func (x *Float32) Swap(val float32) (old float32)

+ func (x *Float32) UnmarshalJSON(b []byte) error

+ type Float64 struct

+ func NewFloat64(val float64) *Float64

+ func (f *Float64) Add(delta float64) float64

+ func (f *Float64) CAS(old, new float64) (swapped bool)

+ func (f *Float64) CompareAndSwap(old, new float64) (swapped bool)

+ func (f *Float64) String() string

+ func (f *Float64) Sub(delta float64) float64

+ func (x *Float64) Load() float64

+ func (x *Float64) MarshalJSON() ([]byte, error)

+ func (x *Float64) Store(val float64)

+ func (x *Float64) Swap(val float64) (old float64)

+ func (x *Float64) UnmarshalJSON(b []byte) error

+ type Int32 struct

+ func NewInt32(val int32) *Int32

+ func (i *Int32) Add(delta int32) int32

+ func (i *Int32) CAS(old, new int32) (swapped bool)

+ func (i *Int32) CompareAndSwap(old, new int32) (swapped bool)

+ func (i *Int32) Dec() int32

+ func (i *Int32) Inc() int32

+ func (i *Int32) Load() int32

+ func (i *Int32) MarshalJSON() ([]byte, error)

+ func (i *Int32) Store(val int32)

+ func (i *Int32) String() string

+ func (i *Int32) Sub(delta int32) int32

+ func (i *Int32) Swap(val int32) (old int32)

+ func (i *Int32) UnmarshalJSON(b []byte) error

+ type Int64 struct

+ func NewInt64(val int64) *Int64

+ func (i *Int64) Add(delta int64) int64

+ func (i *Int64) CAS(old, new int64) (swapped bool)

+ func (i *Int64) CompareAndSwap(old, new int64) (swapped bool)

+ func (i *Int64) Dec() int64

+ func (i *Int64) Inc() int64

+ func (i *Int64) Load() int64

+ func (i *Int64) MarshalJSON() ([]byte, error)

+ func (i *Int64) Store(val int64)

+ func (i *Int64) String() string

+ func (i *Int64) Sub(delta int64) int64

+ func (i *Int64) Swap(val int64) (old int64)

+ func (i *Int64) UnmarshalJSON(b []byte) error

+ type Pointer struct

+ func NewPointer[T any](v *T) *Pointer[T]

+ func (p *Pointer[T]) CompareAndSwap(old, new *T) (swapped bool)

+ func (p *Pointer[T]) Load() *T

+ func (p *Pointer[T]) MarshalJSON() ([]byte, error)

+ func (p *Pointer[T]) Store(val *T)

+ func (p *Pointer[T]) String() string

+ func (p *Pointer[T]) Swap(val *T) (old *T)

+ func (p *Pointer[T]) UnmarshalJSON(b []byte) error

+ type String struct

+ func NewString(val string) *String

+ func (s *String) MarshalText() ([]byte, error)

+ func (s *String) String() string

+ func (s *String) UnmarshalText(b []byte) error

+ func (x *String) CompareAndSwap(old, new string) (swapped bool)

+ func (x *String) Load() string

+ func (x *String) Store(val string)

+ func (x *String) Swap(val string) (old string)

+ type Time struct

+ func NewTime(val time.Time) *Time

+ func (x *Time) Load() time.Time

+ func (x *Time) Store(val time.Time)

+ type Uint32 struct

+ func NewUint32(val uint32) *Uint32

+ func (i *Uint32) Add(delta uint32) uint32

+ func (i *Uint32) CAS(old, new uint32) (swapped bool)

+ func (i *Uint32) CompareAndSwap(old, new uint32) (swapped bool)

+ func (i *Uint32) Dec() uint32

+ func (i *Uint32) Inc() uint32

+ func (i *Uint32) Load() uint32

+ func (i *Uint32) MarshalJSON() ([]byte, error)

+ func (i *Uint32) Store(val uint32)

+ func (i *Uint32) String() string

+ func (i *Uint32) Sub(delta uint32) uint32

+ func (i *Uint32) Swap(val uint32) (old uint32)

+ func (i *Uint32) UnmarshalJSON(b []byte) error

+ type Uint64 struct

+ func NewUint64(val uint64) *Uint64

+ func (i *Uint64) Add(delta uint64) uint64

+ func (i *Uint64) CAS(old, new uint64) (swapped bool)

+ func (i *Uint64) CompareAndSwap(old, new uint64) (swapped bool)

+ func (i *Uint64) Dec() uint64

+ func (i *Uint64) Inc() uint64

+ func (i *Uint64) Load() uint64

+ func (i *Uint64) MarshalJSON() ([]byte, error)

+ func (i *Uint64) Store(val uint64)

+ func (i *Uint64) String() string

+ func (i *Uint64) Sub(delta uint64) uint64

+ func (i *Uint64) Swap(val uint64) (old uint64)

+ func (i *Uint64) UnmarshalJSON(b []byte) error

+ type Uintptr struct

+ func NewUintptr(val uintptr) *Uintptr

+ func (i *Uintptr) Add(delta uintptr) uintptr

+ func (i *Uintptr) CAS(old, new uintptr) (swapped bool)

+ func (i *Uintptr) CompareAndSwap(old, new uintptr) (swapped bool)

+ func (i *Uintptr) Dec() uintptr

+ func (i *Uintptr) Inc() uintptr

+ func (i *Uintptr) Load() uintptr

+ func (i *Uintptr) MarshalJSON() ([]byte, error)

+ func (i *Uintptr) Store(val uintptr)

+ func (i *Uintptr) String() string

+ func (i *Uintptr) Sub(delta uintptr) uintptr

+ func (i *Uintptr) Swap(val uintptr) (old uintptr)

+ func (i *Uintptr) UnmarshalJSON(b []byte) error

+ type UnsafePointer struct

+ func NewUnsafePointer(val unsafe.Pointer) *UnsafePointer

+ func (p *UnsafePointer) CAS(old, new unsafe.Pointer) (swapped bool)

+ func (p *UnsafePointer) CompareAndSwap(old, new unsafe.Pointer) (swapped bool)

+ func (p *UnsafePointer) Load() unsafe.Pointer

+ func (p *UnsafePointer) Store(val unsafe.Pointer)

+ func (p *UnsafePointer) Swap(val unsafe.Pointer) (old unsafe.Pointer)

+ type Value struct

v0

v0.0.1

Jan 10, 2026