База знанияИзпитен център
BGБългарски
Избери език13

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

Източници