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