Andrey Kovalev 7fe2f59f05 go mod tidy && go mod vendor		3 years ago
..
.codecov.yml	go mod tidy && go mod vendor	3 years ago
.gitignore	go mod tidy && go mod vendor	3 years ago
CHANGELOG.md	go mod tidy && go mod vendor	3 years ago
LICENSE.txt	go mod tidy && go mod vendor	3 years ago
Makefile	go mod tidy && go mod vendor	3 years ago
README.md	go mod tidy && go mod vendor	3 years ago
bool.go	go mod tidy && go mod vendor	3 years ago
bool_ext.go	go mod tidy && go mod vendor	3 years ago
doc.go	go mod tidy && go mod vendor	3 years ago
duration.go	go mod tidy && go mod vendor	3 years ago
duration_ext.go	go mod tidy && go mod vendor	3 years ago
error.go	go mod tidy && go mod vendor	3 years ago
error_ext.go	go mod tidy && go mod vendor	3 years ago
float64.go	go mod tidy && go mod vendor	3 years ago
float64_ext.go	go mod tidy && go mod vendor	3 years ago
gen.go	go mod tidy && go mod vendor	3 years ago
int32.go	go mod tidy && go mod vendor	3 years ago
int64.go	go mod tidy && go mod vendor	3 years ago
nocmp.go	go mod tidy && go mod vendor	3 years ago
string.go	go mod tidy && go mod vendor	3 years ago
string_ext.go	go mod tidy && go mod vendor	3 years ago
time.go	go mod tidy && go mod vendor	3 years ago
time_ext.go	go mod tidy && go mod vendor	3 years ago
uint32.go	go mod tidy && go mod vendor	3 years ago
uint64.go	go mod tidy && go mod vendor	3 years ago
uintptr.go	go mod tidy && go mod vendor	3 years ago
unsafe_pointer.go	go mod tidy && go mod vendor	3 years ago
value.go	go mod tidy && go mod vendor	3 years ago

README.md

atomic

Simple wrappers for primitive types to enforce atomic access.

Installation

$ go get -u go.uber.org/atomic@v1

Legacy Import Path

As of v1.5.0, the import path go.uber.org/atomic is the only supported way of using this package. If you are using Go modules, this package will fail to compile with the legacy import path path github.com/uber-go/atomic.

We recommend migrating your code to the new import path but if you're unable to do so, or if your dependencies are still using the old import path, you will have to add a replace directive to your go.mod file downgrading the legacy import path to an older version.

replace github.com/uber-go/atomic => github.com/uber-go/atomic v1.4.0

You can do so automatically by running the following command.

$ go mod edit -replace github.com/uber-go/atomic=github.com/uber-go/atomic@v1.4.0

Usage

The standard library's sync/atomic is powerful, but it's easy to forget which variables must be accessed atomically. go.uber.org/atomic preserves all the functionality of the standard library, but wraps the primitive types to provide a safer, more convenient API.

var atom atomic.Uint32
atom.Store(42)
atom.Sub(2)
atom.CAS(40, 11)

See the documentation for a complete API specification.

Development Status

Stable.

Released under the MIT License.