CKTIS / C++
std::latch — еднократно изчакване броячът да достигне нула
std::latch от <latch> позволява на нишките да изчакат броячът да достигне нула. count_down() отчита завършването на единица работа, а wait() изчаква приключването на обратното броене, без да променя брояча.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <latch>
std::latch done{expected};
done.count_down();
done.wait();std::latch е еднократен механизъм за синхронизация от <latch>. Конструкторът му задава брояча на expected, за което трябва да е изпълнено 0 <= expected && expected <= std::latch::max(). Броячът показва колко сигнала още се очакват, като не е задължително те да идват от различни нишки. След като броячът достигне нула, обектът не може да бъде върнат в начално състояние или използван повторно за нов цикъл.
std::latch::count_down(update) атомарно изважда update; стойността по подразбиране е 1. Трябва да е изпълнено 0 <= update, а update не бива да надвишава текущата стойност на брояча. Затова не извиквайте count_down() със стойността по подразбиране, когато броячът вече е нула. Този метод не изчаква останалите сигнали. std::latch::wait() не намалява брояча: извикването блокира, докато броячът достигне нула, или се връща веднага, ако вече е нула. Ако липсват сигнали, изчакването може да продължи безкрайно.
В C++23 count_down() предхожда в смисъла на отношението strongly happens-before връщането от извикванията, които се отблокират на този обект std::latch. Тази гаранция не обхваща изрично извикване на wait(), което започва, след като броячът е достигнал нула. В примера worker може да извика count_down(), преди главната нишка да извика wait(). Затова само wait() не гарантира, че неатомарното четене на result е безопасно при всяко планиране на нишките. Механизмът не предпазва и от произволни едновременни записи в споделени данни.
Обектът трябва да остане жив по време на операциите върху него. В примера worker се унищожава преди done, но главната нишка не разчита на деструктора на std::jthread: тя извиква изрично worker.join() след wait() и преди да прочете result. Приключването на работната нишка се синхронизира с успешното връщане от worker.join(), така че четенето на result е безопасно независимо дали wait() е блокирало. При успешно изпълнение програмата извежда 42, последвано от знак за нов ред.
Примери
#include <iostream>
#include <latch>
#include <thread>
int main() {
int result = 0;
std::latch done{1};
std::jthread worker([&] {
result = 42;
done.count_down();
});
done.wait();
worker.join();
std::cout << result << '\n';
}
Резултат
42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.