CKTIS / C++
std::barrier: многократна фазова среща
std::barrier синхронизира постоянна група участници в края на всяка фаза и автоматично започва следващата.
Версия: C++23
Синтаксис
template<class CompletionFunction = /* unspecified */>
class barrier {
public:
explicit barrier(std::ptrdiff_t expected, CompletionFunction completion = CompletionFunction());
void arrive_and_wait();
arrival_token arrive(std::ptrdiff_t update = 1);
void wait(arrival_token&& arrival) const;
void arrive_and_drop();
};std::barrier от <barrier> пази очакван брой пристигания за всяка фаза. arrive_and_wait() пристига и чака, arrive() връща token за по-късен wait(), а arrive_and_drop() трайно намалява участниците в следващите фази. std::barrier::arrive_and_wait отчита едно пристигане и чака завършването на фазата. std::barrier::arrive_and_drop отчита пристигане без чакане и трайно намалява с едно очаквания брой пристигания в следващите фази.
Когато броят достигне нула, завършващата стъпка обичайно се изпълнява точно веднъж; ако обаче никоя нишка не извика wait, включително чрез arrive_and_wait, изпълнението зависи от имплементацията. Когато се изпълни, освобождава чакащите и възстановява очаквания брой за следващата фаза. Краят ѝ strongly happens before връщанията от освободените изчаквания, затова по-ранните записи са безопасно видими след това.
expected трябва да е между нула и max(); при нула обектът може само да се унищожи. Всеки участник трябва да спазва протокола или другите могат да чакат вечно. Бариерата не се копира и трябва да надживее всички потребители и tokens.
Примери
#include <barrier>
#include <iostream>
#include <thread>
int main() {
int value = 0;
std::barrier phase{2};
std::jthread worker([&] {
value = 7;
phase.arrive_and_wait();
});
phase.arrive_and_wait();
std::cout << value << '\n';
}
Резултат
7
std::barrier → 7