# 标准库头文件 <stdatomic.h>

< cpp‎ | header

此头文件最初在 C 标准库。

此头文件是原子操作库的一部分。

未指定 `<stdatomic.h>` 是否提供任何命名空间 `std` 中的声明。

### 宏
_Atomic (C++23) | 使得 _Atomic(T) 等同于 std::atomic<T> 的兼容性宏 (宏函数)
### 类型
atomic_flag (C++11) | 免锁的布尔原子类型 (类)
memory_order (C++11) | 为给定的原子操作定义内存顺序约束 (枚举)
atomic_bool (C++11) | std::atomic<bool> (typedef)
atomic_char (C++11) | std::atomic<char> (typedef)
atomic_schar (C++11) | std::atomic<signed char> (typedef)
atomic_uchar (C++11) | std::atomic<unsigned char> (typedef)
atomic_short (C++11) | std::atomic<short> (typedef)
atomic_ushort (C++11) | std::atomic<unsigned short> (typedef)
atomic_int (C++11) | std::atomic<int> (typedef)
atomic_uint (C++11) | std::atomic<unsigned int> (typedef)
atomic_long (C++11) | std::atomic<long> (typedef)
atomic_ulong (C++11) | std::atomic<unsigned long> (typedef)
atomic_llong (C++11) | std::atomic<long long> (typedef)
atomic_ullong (C++11) | std::atomic<unsigned long long> (typedef)
atomic_char8_t (C++20) | std::atomic<char8_t> (typedef)
atomic_char16_t (C++11) | std::atomic<char16_t> (typedef)
atomic_char32_t (C++11) | std::atomic<char32_t> (typedef)
atomic_wchar_t (C++11) | std::atomic<wchar_t> (typedef)
atomic_int8_t (C++11)(可选) | std::atomic<std::int8_t> (typedef)
atomic_uint8_t (C++11)(可选) | std::atomic<std::uint8_t> (typedef)
atomic_int16_t (C++11)(可选) | std::atomic<std::int16_t> (typedef)
atomic_uint16_t (C++11)(可选) | std::atomic<std::uint16_t> (typedef)
atomic_int32_t (C++11)(可选) | std::atomic<std::int32_t> (typedef)
atomic_uint32_t (C++11)(可选) | std::atomic<std::uint32_t> (typedef)
atomic_int64_t (C++11)(可选) | std::atomic<std::int64_t> (typedef)
atomic_uint64_t (C++11)(可选) | std::atomic<std::uint64_t> (typedef)
atomic_int_least8_t (C++11) | std::atomic<std::int_least8_t> (typedef)
atomic_uint_least8_t (C++11) | std::atomic<std::uint_least8_t> (typedef)
atomic_int_least16_t (C++11) | std::atomic<std::int_least16_t> (typedef)
atomic_uint_least16_t (C++11) | std::atomic<std::uint_least16_t> (typedef)
atomic_int_least32_t (C++11) | std::atomic<std::int_least32_t> (typedef)
atomic_uint_least32_t (C++11) | std::atomic<std::uint_least32_t> (typedef)
atomic_int_least64_t (C++11) | std::atomic<std::int_least64_t> (typedef)
atomic_uint_least64_t (C++11) | std::atomic<std::uint_least64_t> (typedef)
atomic_int_fast8_t (C++11) | std::atomic<std::int_fast8_t> (typedef)
atomic_uint_fast8_t (C++11) | std::atomic<std::uint_fast8_t> (typedef)
atomic_int_fast16_t (C++11) | std::atomic<std::int_fast16_t> (typedef)
atomic_uint_fast16_t (C++11) | std::atomic<std::uint_fast16_t> (typedef)
atomic_int_fast32_t (C++11) | std::atomic<std::int_fast32_t> (typedef)
atomic_uint_fast32_t (C++11) | std::atomic<std::uint_fast32_t> (typedef)
atomic_int_fast64_t (C++11) | std::atomic<std::int_fast64_t> (typedef)
atomic_uint_fast64_t (C++11) | std::atomic<std::uint_fast64_t> (typedef)
atomic_intptr_t (C++11)(可选) | std::atomic<std::intptr_t> (typedef)
atomic_uintptr_t (C++11)(可选) | std::atomic<std::uintptr_t> (typedef)
atomic_size_t (C++11) | std::atomic<std::size_t> (typedef)
atomic_ptrdiff_t (C++11) | std::atomic<std::ptrdiff_t> (typedef)
atomic_intmax_t (C++11) | std::atomic<std::intmax_t> (typedef)
atomic_uintmax_t (C++11) | std::atomic<std::uintmax_t> (typedef)
### 函数
atomic_is_lock_free (C++11) | 检查对该原子类型的操作是否是无锁的 (函数模板)
atomic_store atomic_store_explicit (C++11)(C++11) | 原子地以非原子实参替换原子对象的值 (函数模板)
atomic_load atomic_load_explicit (C++11)(C++11) | 原子地获得存储于原子对象的值 (函数模板)
atomic_exchange atomic_exchange_explicit (C++11)(C++11) | 原子地以非原子实参的值替换原子对象的值，并返回该原子对象的旧值 (函数模板)
atomic_compare_exchange_weak atomic_compare_exchange_weak_explicit atomic_compare_exchange_strong atomic_compare_exchange_strong_explicit (C++11)(C++11)(C++11)(C++11) | 原子地比较原子对象和非原子实参的值，若相等则进行 atomic_exchange，若不相等则进行 atomic_load (函数模板)
atomic_fetch_add atomic_fetch_add_explicit (C++11)(C++11) | 将非原子值加到原子对象，并获得原子对象的先前值 (函数模板)
atomic_fetch_sub atomic_fetch_sub_explicit (C++11)(C++11) | 从原子对象减去非原子值，并获得原子对象的先前值 (函数模板)
atomic_fetch_and atomic_fetch_and_explicit (C++11)(C++11) | 将原子对象替换为与非原子实参逻辑与的结果，并获得原子对象的先前值 (函数模板)
atomic_fetch_or atomic_fetch_or_explicit (C++11)(C++11) | 将原子对象替换为与非原子实参逻辑或的结果，并获得原子对象的先前值 (函数模板)
atomic_fetch_xor atomic_fetch_xor_explicit (C++11)(C++11) | 将原子对象替换为与非原子实参逻辑异或的结果，并获得原子对象的先前值 (函数模板)
atomic_flag_test_and_set atomic_flag_test_and_set_explicit (C++11)(C++11) | 原子地设置标志为 true 并返回其先前值 (函数)
atomic_flag_clear atomic_flag_clear_explicit (C++11)(C++11) | 原子地设置标志值为 false (函数)
atomic_thread_fence (C++11) | 通用的依赖内存顺序的栅栏同步原语 (函数)
atomic_signal_fence (C++11) | 线程与执行于同一线程的信号处理函数间的栅栏 (函数)

### 概要

    template<class T>
      using __std_atomic = std::atomic<T>;        // 仅用于阐释

    #define _Atomic(T) __std_atomic<T>

    #define ATOMIC_BOOL_LOCK_FREE /* 见描述 */
    #define ATOMIC_CHAR_LOCK_FREE /* 见描述 */
    #define ATOMIC_CHAR16_T_LOCK_FREE /* 见描述 */
    #define ATOMIC_CHAR32_T_LOCK_FREE /* 见描述 */
    #define ATOMIC_WCHAR_T_LOCK_FREE /* 见描述 */
    #define ATOMIC_SHORT_LOCK_FREE /* 见描述 */
    #define ATOMIC_INT_LOCK_FREE /* 见描述 */
    #define ATOMIC_LONG_LOCK_FREE /* 见描述 */
    #define ATOMIC_LLONG_LOCK_FREE /* 见描述 */
    #define ATOMIC_POINTER_LOCK_FREE /* 见描述 */

    using std::memory_order;                // 见描述
    using std::memory_order_relaxed;        // 见描述
    using std::memory_order_consume;        // 见描述
    using std::memory_order_acquire;        // 见描述
    using std::memory_order_release;        // 见描述
    using std::memory_order_acq_rel;        // 见描述
    using std::memory_order_seq_cst;        // 见描述

    using std::atomic_flag;                 // 见描述

    using std::atomic_bool;                 // 见描述
    using std::atomic_char;                 // 见描述
    using std::atomic_schar;                // 见描述
    using std::atomic_uchar;                // 见描述
    using std::atomic_short;                // 见描述
    using std::atomic_ushort;               // 见描述
    using std::atomic_int;                  // 见描述
    using std::atomic_uint;                 // 见描述
    using std::atomic_long;                 // 见描述
    using std::atomic_ulong;                // 见描述
    using std::atomic_llong;                // 见描述
    using std::atomic_ullong;               // 见描述
    using std::atomic_char8_t;              // 见描述
    using std::atomic_char16_t;             // 见描述
    using std::atomic_char32_t;             // 见描述
    using std::atomic_wchar_t;              // 见描述
    using std::atomic_int8_t;               // 见描述
    using std::atomic_uint8_t;              // 见描述
    using std::atomic_int16_t;              // 见描述
    using std::atomic_uint16_t;             // 见描述
    using std::atomic_int32_t;              // 见描述
    using std::atomic_uint32_t;             // 见描述
    using std::atomic_int64_t;              // 见描述
    using std::atomic_uint64_t;             // 见描述
    using std::atomic_int_least8_t;         // 见描述
    using std::atomic_uint_least8_t;        // 见描述
    using std::atomic_int_least16_t;        // 见描述
    using std::atomic_uint_least16_t;       // 见描述
    using std::atomic_int_least32_t;        // 见描述
    using std::atomic_uint_least32_t;       // 见描述
    using std::atomic_int_least64_t;        // 见描述
    using std::atomic_uint_least64_t;       // 见描述
    using std::atomic_int_fast8_t;          // 见描述
    using std::atomic_uint_fast8_t;         // 见描述
    using std::atomic_int_fast16_t;         // 见描述
    using std::atomic_uint_fast16_t;        // 见描述
    using std::atomic_int_fast32_t;         // 见描述
    using std::atomic_uint_fast32_t;        // 见描述
    using std::atomic_int_fast64_t;         // 见描述
    using std::atomic_uint_fast64_t;        // 见描述
    using std::atomic_intptr_t;             // 见描述
    using std::atomic_uintptr_t;            // 见描述
    using std::atomic_size_t;               // 见描述
    using std::atomic_ptrdiff_t;            // 见描述
    using std::atomic_intmax_t;             // 见描述
    using std::atomic_uintmax_t;            // 见描述

    using std::atomic_is_lock_free;                         // 见描述
    using std::atomic_load;                                 // 见描述
    using std::atomic_load_explicit;                        // 见描述
    using std::atomic_store;                                // 见描述
    using std::atomic_store_explicit;                       // 见描述
    using std::atomic_exchange;                             // 见描述
    using std::atomic_exchange_explicit;                    // 见描述
    using std::atomic_compare_exchange_strong;              // 见描述
    using std::atomic_compare_exchange_strong_explicit;     // 见描述
    using std::atomic_compare_exchange_weak;                // 见描述
    using std::atomic_compare_exchange_weak_explicit;       // 见描述
    using std::atomic_fetch_add;                            // 见描述
    using std::atomic_fetch_add_explicit;                   // 见描述
    using std::atomic_fetch_sub;                            // 见描述
    using std::atomic_fetch_sub_explicit;                   // 见描述
    using std::atomic_fetch_or;                             // 见描述
    using std::atomic_fetch_or_explicit;                    // 见描述
    using std::atomic_fetch_and;                            // 见描述
    using std::atomic_fetch_and_explicit;                   // 见描述
    using std::atomic_flag_test_and_set;                    // 见描述
    using std::atomic_flag_test_and_set_explicit;           // 见描述
    using std::atomic_flag_clear;                           // 见描述
    using std::atomic_flag_clear_explicit;                  // 见描述

    using std::atomic_thread_fence;                         // 见描述
    using std::atomic_signal_fence;                         // 见描述