Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::counting_semaphore: obmedzenie súbežných prístupov

std::counting_semaphore udržiava počet povolení; acquire jedno spotrebuje a release povolenia vracia a môže odblokovať čakajúce vlákno.

Verzia: C++23

Syntax

template<std::ptrdiff_t LeastMaxValue = /* implementation-defined */>
class counting_semaphore {
public:
    static constexpr std::ptrdiff_t max() noexcept;
    constexpr explicit counting_semaphore(std::ptrdiff_t desired);
    void release(std::ptrdiff_t update = 1);
    void acquire();
    bool try_acquire() noexcept;
};

std::counting_semaphore<LeastMaxValue> z <semaphore> udržiava nezáporné počítadlo. acquire() čaká na kladnú hodnotu a atomicky ju zníži; release(update) atomicky pripočíta update a odblokuje čakajúcich. Účinok release silno predchádza úspešnému získaniu, ktoré tento účinok pozoruje.

std::counting_semaphore::acquire blokuje, kým úspešne atomicky nezníži kladný čítač. std::counting_semaphore::release atomicky zvýši čítač o update a odblokuje čakajúcich, s predpokladom 0 <= update <= max() - counter. std::counting_semaphore::max vracia najväčšiu podporovanú hodnotu čítača, aspoň LeastMaxValue, nie aktuálny počet povolení.

LeastMaxValue musí byť nezáporné. Konštruktor vyžaduje 0 <= desired && desired <= max() a release vyžaduje 0 <= update && update <= max() - counter; prekročenie kapacity porušuje predpoklad. Objekt nemožno kopírovať a deštrukcia nesmie súperiť s vláknami, ktoré ho ešte používajú.

try_acquire() neblokuje, ale môže falošne vrátiť false aj pri kladnom počítadle. Časované varianty môžu skončiť po termíne. Semafor odovzdáva povolenia; sám nechráni ľubovoľné dáta ako mutex, takže zdieľaný stav stále potrebuje správny synchronizačný protokol.

Príklady

#include <iostream>
#include <semaphore>
#include <thread>

int main() {
    std::counting_semaphore<1> ready{0};
    int value = 0;

    std::jthread worker([&] {
        ready.acquire();
        value = 42;
    });

    ready.release();
    worker.join();
    std::cout << value << '\n';
}

Výsledok

42

std::counting_semaphore → 42

Zdroje