cppreference.net

Namespaces

Page

Variants

Atomic operations library

From cppreference.net

< c

如果编译器定义了宏常量 __STDC_NO_ATOMICS__ (C11) ，则不会提供头文件 <stdatomic.h> 、关键字 _Atomic 以及此处列出的所有名称。

目录

类型

定义于头文件 `<stdatomic.h>`
memory_order (C11)	定义内存顺序约束 (枚举)
atomic_flag (C11)	无锁原子布尔标志 (结构体)

宏

定义于头文件 `<stdatomic.h>`
ATOMIC_BOOL_LOCK_FREE ATOMIC_CHAR_LOCK_FREE ATOMIC_CHAR16_T_LOCK_FREE ATOMIC_CHAR32_T_LOCK_FREE ATOMIC_WCHAR_T_LOCK_FREE ATOMIC_SHORT_LOCK_FREE ATOMIC_INT_LOCK_FREE ATOMIC_LONG_LOCK_FREE ATOMIC_LLONG_LOCK_FREE ATOMIC_POINTER_LOCK_FREE (C11)	指示给定原子类型是否为无锁的 (宏常量)
ATOMIC_FLAG_INIT (C11)	初始化新的 atomic_flag (宏常量)
ATOMIC_VAR_INIT (C11) (C17 中弃用) (C23 中移除)	初始化新的原子对象 (函数宏)
kill_dependency (C11)	为 memory_order_consume 打破依赖链 (函数宏)

函数

定义于头文件 `<stdatomic.h>`
atomic_flag_test_and_set atomic_flag_test_and_set_explicit (C11)	将 atomic_flag 设为 true 并返回旧值 (函数)
atomic_flag_clear atomic_flag_clear_explicit (C11)	将 atomic_flag 设为 false (函数)
atomic_init (C11)	初始化已有的原子对象 (函数)
atomic_is_lock_free (C11)	指示原子对象是否为无锁的 (函数)
atomic_store atomic_store_explicit (C11)	在原子对象中存储值 (函数)
atomic_load atomic_load_explicit (C11)	从原子对象读取值 (函数)
atomic_exchange atomic_exchange_explicit (C11)	将值与原子对象的值进行交换 (函数)
atomic_compare_exchange_strong atomic_compare_exchange_strong_explicit atomic_compare_exchange_weak atomic_compare_exchange_weak_explicit (C11)	若旧值符合预期则交换值与原子对象，否则读取旧值 (函数)
atomic_fetch_add atomic_fetch_add_explicit (C11)	原子加法 (函数)
atomic_fetch_sub atomic_fetch_sub_explicit (C11)	原子减法 (函数)
atomic_fetch_or atomic_fetch_or_explicit (C11)	原子按位或 (函数)
atomic_fetch_xor atomic_fetch_xor_explicit (C11)	原子按位异或 (函数)
atomic_fetch_and atomic_fetch_and_explicit (C11)	原子按位与 (函数)
atomic_thread_fence (C11)	通用的内存顺序相关栅栏同步原语 (函数)
atomic_signal_fence (C11)	同一线程内线程与信号处理函数之间的栅栏 (函数)

类型

标准库为核心语言原子类型提供了便利的类型定义。

类型定义名称	完整类型名称
`atomic_bool`	_Atomic _Bool
`atomic_char`	_Atomic char
`atomic_schar`	_Atomic signed char
`atomic_uchar`	_Atomic unsigned char
`atomic_short`	_Atomic short
`atomic_ushort`	_Atomic unsigned short
`atomic_int`	_Atomic int
`atomic_uint`	_Atomic unsigned int
`atomic_long`	_Atomic long
`atomic_ulong`	_Atomic unsigned long
`atomic_llong`	_Atomic long long
`atomic_ullong`	_Atomic unsigned long long
`atomic_char8_t` (C23)	_Atomic char8_t
`atomic_char16_t`	_Atomic char16_t
`atomic_char32_t`	_Atomic char32_t
`atomic_wchar_t`	_Atomic wchar_t
`atomic_int_least8_t`	_Atomic int_least8_t
`atomic_uint_least8_t`	_Atomic uint_least8_t
`atomic_int_least16_t`	_Atomic int_least16_t
`atomic_uint_least16_t`	_Atomic uint_least16_t
`atomic_int_least32_t`	_Atomic int_least32_t
`atomic_uint_least32_t`	_Atomic uint_least32_t
`atomic_int_least64_t`	_Atomic int_least64_t
`atomic_uint_least64_t`	_Atomic uint_least64_t
`atomic_int_fast8_t`	_Atomic int_fast8_t
`atomic_uint_fast8_t`	_Atomic uint_fast8_t
`atomic_int_fast16_t`	_Atomic int_fast16_t
`atomic_uint_fast16_t`	_Atomic uint_fast16_t
`atomic_int_fast32_t`	_Atomic int_fast32_t
`atomic_uint_fast32_t`	_Atomic uint_fast32_t
`atomic_int_fast64_t`	_Atomic int_fast64_t
`atomic_uint_fast64_t`	_Atomic uint_fast64_t
`atomic_intptr_t`	_Atomic intptr_t
`atomic_uintptr_t`	_Atomic uintptr_t
`atomic_size_t`	_Atomic size_t
`atomic_ptrdiff_t`	_Atomic ptrdiff_t
`atomic_intmax_t`	_Atomic intmax_t
`atomic_uintmax_t`	_Atomic uintmax_t

参考文献

C23 标准 (ISO/IEC 9899:2024):

7.17 原子操作 <stdatomic.h> (页: TBD)

7.31.8 原子操作 <stdatomic.h> (页: TBD)

C17 标准 (ISO/IEC 9899:2018):

7.17 原子操作 <stdatomic.h> (页: TBD)

7.31.8 原子操作 <stdatomic.h> (页: TBD)

C11 标准 (ISO/IEC 9899:2011):

7.17 原子操作 <stdatomic.h> (页: 273-286)

7.31.8 原子操作 <stdatomic.h> (页: 455-456)

参见

C++ 文档关于原子操作库