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

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници