CKTIS / C++
std::atomic: atomaire toegang tot een gedeelde waarde
std::atomic biedt ondeelbare loads, stores en read-modify-write-bewerkingen op één object met instelbare geheugenordening.
Versie: C++23
Syntax
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> uit <atomic> biedt de gemeenschappelijke bewerkingen load, store, exchange en compare-exchange op één waarde; standaard geldt std::memory_order_seq_cst. fetch_add hoort niet bij elke atomic<T> maar alleen bij passende specialisaties, waaronder numerieke en pointerspecialisaties. Voor de primaire template moet T triviaal kopieerbaar, kopieer- en verplaatsbaar construeerbaar, kopieer- en verplaatsbaar toewijsbaar en niet cv-gekwalificeerd zijn. std::atomic::load voert een atomaire leesbewerking uit en staat release- of acq_rel-ordening niet toe; std::atomic::store schrijft atomair en staat consume, acquire of acq_rel niet toe. Bij een toepasselijke specialisatie is std::atomic::fetch_add één read-modify-write-bewerking die de waarde direct vóór de optelling retourneert; std::atomic::is_lock_free meldt of de bewerkingen van dit object lock-free zijn.
Atomiciteit van één variabele maakt een heel protocol niet atomair. Bij zwakkere ordeningen moet de synchronisatierelatie bewezen zijn; een verkeerde mix van relaxed, acquire en release kan logisch fout zijn zonder data race.
Een atomic is niet noodzakelijk lock-free; controleer is_lock_free(). Atomaire objecten worden niet als gewone waarden gekopieerd. compare_exchange_weak kan schijnbaar falen, hoort daarom vaak in een lus en werkt bij falen de verwachte waarde bij.
Voorbeelden
#include <atomic>
#include <iostream>
int main() {
std::atomic<int> value{3};
value.fetch_add(4);
std::cout << value.load() << '\n';
}
Resultaat
7
std::atomic → 7