CKTIS / C++
std::memory_order — poradie atómových operácií
std::memory_order z <atomic> určuje poradie a synchronizáciu atómových operácií. Rozlišuje samotnú atomicitu od bezpečného sprístupnenia údajov medzi vláknami; nesprávne oslabenie poradia môže spôsobiť dátový súbeh.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <atomic>
// Examples of explicit ordering:
flag.store(true, std::memory_order::release);
bool value = flag.load(std::memory_order::acquire);std::memory_order je výčtový typ z <atomic>, ktorý sa odovzdáva atómovým operáciám. Atomicita sa týka konkrétneho objektu; poradie pamäte určuje ďalšie záruky pre ostatné čítania a zápisy. relaxed zachováva atomicitu a poradie zmien daného objektu, ale samo osebe nesynchronizuje prístup k iným údajom.
release zverejňuje predchádzajúce zápisy a acquire umožňuje ich bezpečné pozorovanie: čítanie acquire sa synchronizuje so zápisom release, ak načíta jeho hodnotu alebo číta z príslušnej sekvencie release. acq_rel spája oba smery v operácii čítanie–zmena–zápis. seq_cst, predvolená hodnota pri mnohých atómových operáciách, sa navyše zúčastňuje jediného úplného poradia operácií seq_cst; automaticky neusporadúva všetky akcie programu.
V C++23 opisuje consume slabšie poradie založené na dátových závislostiach, nie úplné poradie acquire. Poznámka k verzii: odkazovaný priebežne upravovaný návrh nie je nemenným znením C++23 — v súčasnosti opisuje consume ako zastaraný ekvivalent acquire. Pri bežnom zverejňovaní údajov používajte release/acquire namiesto spoliehania sa na jemnosti consume.
Pre store sú povolené poradia relaxed, release, seq_cst; pre load v C++23: relaxed, consume, acquire, seq_cst. acq_rel nie je platné pre samotné load ani store. Neplatné poradie porušuje požiadavky operácie; volatile nenahrádza synchronizáciu.
V príklade sa wait s acquire vráti až po pozorovaní inej hodnoty než false. Načíta true zverejnené pomocou release, takže zápis do payload predchádza jeho čítaniu vo vzťahu happens-before a výstup je 42. Samotné notify_one() údaje nezverejňuje. Nahradenie oboch poradí hodnotou relaxed by odstránilo túto záruku a umožnilo dátový súbeh na payload.
Príklady
#include <atomic>
#include <iostream>
#include <thread>
int main() {
int payload = 0;
std::atomic<bool> ready{false};
std::thread producer([&] {
payload = 42;
ready.store(true, std::memory_order::release);
ready.notify_one();
});
ready.wait(false, std::memory_order::acquire);
std::cout << payload << '\n';
producer.join();
}
Výsledok
42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.