KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen