CKTIS / C++
std::atomic: atomický přístup ke sdílené hodnotě
std::atomic poskytuje nedělitelné čtení, zápis a read-modify-write operace nad jedním objektem s volitelným pořadím paměti.
Verze: C++23
Syntaxe
template<class T>
struct atomic; // T: non-cv, trivially copyable, copy/move constructible and assignable
// common selected operations
T load(std::memory_order order = std::memory_order_seq_cst) const noexcept;
void store(T desired, std::memory_order order = std::memory_order_seq_cst) noexcept;
bool is_lock_free() const noexcept;
T exchange(T desired, std::memory_order order = std::memory_order_seq_cst) noexcept;
// applicable numeric and pointer specializations additionally provide:
T fetch_add(/* difference type */ operand,
std::memory_order order = std::memory_order_seq_cst) noexcept;std::atomic<T> z <atomic> poskytuje společné operace load, store, exchange a compare-exchange nad jednou hodnotou; výchozí pořadí je std::memory_order_seq_cst. fetch_add není součástí každého atomic<T> a poskytují jej jen vhodné specializace, včetně číselných a ukazatelových. Pro primární šablonu musí být T triviálně kopírovatelný, kopírovatelně i přesunově konstruovatelný a přiřaditelný a bez cv kvalifikace. std::atomic::load provede atomické čtení a nepovoluje pořadí release ani acq_rel; std::atomic::store provede atomický zápis a nepovoluje consume, acquire ani acq_rel. U vhodné specializace je std::atomic::fetch_add jediná read-modify-write operace a vrací hodnotu bezprostředně před přičtením; std::atomic::is_lock_free sdělí, zda jsou operace tohoto objektu bez zámku.
Atomičnost jedné proměnné nedělá atomickým celý protokol. U slabších pořadí je nutné dokázat synchronizaci; chybná směs relaxed, acquire a release může být logicky špatná i bez data race.
Atomic nemusí být lock-free; ověř is_lock_free(). Atomické objekty se nekopírují jako běžné hodnoty. compare_exchange_weak může selhat zdánlivě, proto bývá ve smyčce a při selhání aktualizuje očekávanou hodnotu.
Příklady
#include <atomic>
#include <iostream>
int main() {
std::atomic<int> value{3};
value.fetch_add(4);
std::cout << value.load() << '\n';
}
Výsledek
7
std::atomic → 7