CKTIS / C++
std::atomic: atomowy dostęp do współdzielonej wartości
std::atomic udostępnia niepodzielne odczyty, zapisy i operacje read-modify-write na jednym obiekcie oraz pozwala określić porządek pamięci.
Wersja: C++23
Składnia
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> udostępnia wspólne operacje load, store, exchange i compare-exchange na pojedynczej wartości; domyślny porządek to std::memory_order_seq_cst. fetch_add nie należy do interfejsu każdego atomic<T>: występuje tylko w odpowiednich specjalizacjach, między innymi liczbowych i wskaźnikowych. Dla szablonu podstawowego T musi być trywialnie kopiowalny, umożliwiać konstruowanie oraz przypisanie zarówno przez kopiowanie, jak i przeniesienie, a także być pozbawiony kwalifikatorów cv. std::atomic::load wykonuje odczyt atomowy i nie dopuszcza porządku release ani acq_rel; std::atomic::store wykonuje zapis atomowy i nie dopuszcza consume, acquire ani acq_rel. W odpowiedniej specjalizacji std::atomic::fetch_add jest pojedynczą operacją read-modify-write i zwraca wartość bezpośrednio sprzed dodania, a std::atomic::is_lock_free informuje, czy operacje tego obiektu są bezblokadowe.
Atomowość jednej zmiennej nie czyni całego protokołu atomowym. Dla słabszych porządków trzeba udowodnić relację synchronizacji; błędne połączenie relaxed, acquire i release może dać logicznie niepoprawny wynik mimo braku data race.
Typ atomowy nie jest zwykłym zamiennikiem blokady: może nie być lock-free, co sprawdza is_lock_free(). Obiektów atomic nie kopiuje się jak wartości. compare_exchange_weak może zawieść pozornie, więc zwykle działa w pętli, a oczekiwana wartość jest przy porażce aktualizowana.
Przykłady
#include <atomic>
#include <iostream>
int main() {
std::atomic<int> value{3};
value.fetch_add(4);
std::cout << value.load() << '\n';
}
Wynik
7
std::atomic → 7