<atomic>

定義類別和樣板類別用來建立支援基本作業的類型。

#include <atomic>

備註

注意事項
使用 /clr 或 /clr:pure，以編譯的程式碼，這個標題會停止。

基本作業可以協助您使用多執行緒正確操作物件，而不需要使用 Mutex 鎖定的兩個主要屬性。

• 由於基本作業不能被的，相同物件的第二部分完成從不同的執行緒可能在第一個基本作業前後只取得物件的狀態。

• 根據其 memory_order 引數，基本作業在相同執行緒上建立其他基本作業的可視性的要求。 因此，它會禁止違反排序要求的編譯器最佳化。

在某些平台上，有效率地實作型別陣列的基本作業可能是不可能的，而不使用 mutex 鎖定。 如果該型別使用的基本作業不會鎖定，原子型別是 無鎖定 。

類別提供 atomic_flag 含有 bool 旗標的最小的原子型別。 其作業永遠是無鎖定。

樣板類別 atomic<Ty> 儲存其引數型別 Ty 物件並提供對該的原子存取儲存的值。 您可以將它具現化使用 memcmp，可以重複使用 memcpy 和用於相等測試中的任何型別。 特別是，您可以將它與符合這些需求和，在許多情況下，使用浮點型別的使用者定義型別。

範本也有一組整數型別的特製化和指標的部分特製化。 這些特製化提供透過主要樣板沒有可用的其他作業。

指標特製化

atomic<Ty *> 部分特製化適用於所有指標型別。 它們為指標算術提供方法。

整數特製化

atomic<integral> 特製化適用於所有整數型別。 它們提供透過主要樣板沒有可用的其他作業。

每個 atomic<integral> 型別具有您在 if directive 可以用來判斷在編譯時期的對應巨集在該型別的作業是否為無鎖定。 如果巨集的值為零，在型別的作業不是無鎖定。 如果值是一，作業可能是無鎖定，因此，需要執行階段檢查。 如果值是、，作業是無鎖定。 您可以使用函式 atomic_is_lock_free 判斷在執行階段是型別的作業是否為無鎖定。

對於每一個整數型別，則處理該整數型別物件的對應名為原子型別。 每個 atomic_integral 型別具有相同的一組成員函式。 atomic<Ty> 的對應的執行個體化，而且可以傳遞至任何非成員函式不可部分完成的作業。

atomic_integral 型別	整數類資料型別	atomic_is_lock_free 巨集
atomic_char	char	ATOMIC_CHAR_LOCK_FREE
atomic_schar	signed char	ATOMIC_CHAR_LOCK_FREE
atomic_uchar	unsigned char	ATOMIC_CHAR_LOCK_FREE
atomic_char16_t	char16_t	ATOMIC_CHAR16_T_LOCK_FREE
atomic_char32_t	char32_t	ATOMIC_CHAR32_T_LOCK_FREE
atomic_wchar_t	wchar_t	ATOMIC_WCHAR_T_LOCK_FREE
atomic_short	short	ATOMIC_SHORT_LOCK_FREE
atomic_ushort	unsigned short	ATOMIC_SHORT_LOCK_FREE
atomic_int	int	ATOMIC_INT_LOCK_FREE
atomic_uint	unsigned int	ATOMIC_INT_LOCK_FREE
atomic_long	long	ATOMIC_LONG_LOCK_FREE
atomic_ulong	unsigned long	ATOMIC_LONG_LOCK_FREE
atomic_llong	long long	ATOMIC_LLONG_LOCK_FREE
atomic_ullong	unsigned long long	ATOMIC_LLONG_LOCK_FREE

Typedef 名稱為不可部分完成樣板的特製化在標題 <inttypes.h>定義的某些存在的型別。

原子型別	Typedef 名稱
atomic_int8_t	atomic<int8_t>
atomic_uint8_t	atomic<uint8_t>
atomic_int16_t	atomic<int16_t>
atomic_uint16_t	atomic<uint16_t>
atomic_int32_t	atomic<int32_t>
atomic_uint32_t	atomic<uint32_t>
atomic_int64_t	atomic<int64_t>
atomic_uint64_t	atomic<uint64_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_	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>

Structs

名稱	描述
不可部分完成的結構	描述對儲存值的基本作業的物件。
atomic_flag 結構	描述原子集合和清除 bool 旗標的物件。

列舉

名稱	描述
memory_order 列舉	提供的符號名稱。在記憶體位置的同步處理作業。 這些作業會影響執行緒的工作方式變成可見在另一個。

功能

下列清單中，在 _explicit 不結束函式有對應的 _explicit的語意，不過，它們會 memory_order_seq_cst的隱含 memory_order 引數。

名稱	描述
atomic_compare_exchange_strong 函式	執行不可部分完成的 比較和交換的 作業。
atomic_compare_exchange_strong_explicit 函式	執行不可部分完成的 比較和交換的 作業。
atomic_compare_exchange_weak 函式	執行弱 原子比較和交換的 作業。
atomic_compare_exchange_weak_explicit 函式	執行弱 原子比較和交換的 作業。
atomic_exchange 函式	取代的儲存值。
atomic_exchange_explicit 函式	取代的儲存值。
atomic_fetch_add 函式	將指定的值加入至現有的儲存值。
atomic_fetch_add_explicit 函式	將指定的值加入至現有的儲存值。
atomic_fetch_and 函式	執行位元在某個值與現有的儲存值的 and 。
atomic_fetch_and_explicit 函式	執行位元在某個值與現有的儲存值的 and 。
atomic_fetch_or 函式	執行位元在某個值與現有的儲存值的 or 。
atomic_fetch_or_explicit 函式	執行位元在某個值與現有的儲存值的 or 。
atomic_fetch_sub 函式	從現有的儲存值減去某個值。
atomic_fetch_sub_explicit 函式	從現有的儲存值減去某個值。
atomic_fetch_xor 函式	執行位元在某個值與現有的儲存值的 exclusive or 。
atomic_fetch_xor_explicit 函式	執行位元在某個值與現有的儲存值的 exclusive or 。
atomic_flag_clear 函式	將一 atomic_flag 物件的旗標傳遞至 false。
atomic_flag_clear_explicit 函式	將一 atomic_flag 物件的旗標傳遞至 false。
atomic_flag_test_and_set 函式	將一 atomic_flag 物件的旗標傳遞至 true。
atomic_flag_test_and_set_explicit 函式	將一 atomic_flag 物件的旗標傳遞至 true。
atomic_init 函式	設定 atomic 物件的儲存值。
atomic_is_lock_free 函式	指定在指定物件的基本作業是否為無鎖定。
atomic_load 函式	擷取原子值。
atomic_load_explicit 函式	擷取原子值。
atomic_signal_fence 函式	做為在呼叫的執行緒會在柵欄之間的記憶體排序要求有訊號處理常式便會執行在相同執行緒上 柵欄 。
atomic_store 函式	儲存原子值。
atomic_store_explicit 函式	儲存原子值。
atomic_thread_fence 函式	為建立記憶體排序要求有關其他柵欄的 柵欄 。
kill_dependency 函式	中斷一個可能的相依性鏈結。

請參閱

參考

標準樣板程式庫

其他資源

標頭檔