github.com/primecitizens/pcz/std@v0.2.1/core/atomic/doc.go (about)

     1  // SPDX-License-Identifier: Apache-2.0
     2  // Copyright 2023 The Prime Citizens
     3  //
     4  // Copyright 2021 The Go Authors. All rights reserved.
     5  // Use of this source code is governed by a BSD-style
     6  // license that can be found in the LICENSE file.
     7  
     8  // Package atomic provides atomic operations.
     9  //
    10  // On most platforms, the compiler is aware of the functions defined
    11  // in this package, and they're replaced with platform-specific intrinsics.
    12  // On other platforms, generic implementations are made available.
    13  //
    14  // Unless otherwise noted, operations defined in this package are sequentially
    15  // consistent across threads with respect to the values they manipulate. More
    16  // specifically, operations that happen in a specific order on one thread,
    17  // will always be observed to happen in exactly that order by another thread.
    18  package atomic
    19  
    20  // NOTE: this package MUST be in the exact package runtime/internal/atomic to
    21  // get functions repalced by compiler intrinsics.
    22  //
    23  // See $GOROOT/src/cmd/compile/internal/ssagen/ssa.go#func:InitTables
    24  //
    25  //pcz:importpath runtime/internal/atomic