Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::counting_semaphore: ograničavanje istodobnih pristupa

std::counting_semaphore održava broj dozvola; acquire jednu troši, a release ih vraća i može odblokirati dretvu.

Verzija: C++23

Sintaksa

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> iz <semaphore> održava nenegativan brojač. acquire() čeka pozitivnu vrijednost i atomski je smanjuje; release(update) atomski dodaje update i odblokira čekajuće. Učinak release snažno prethodi uspješnom preuzimanju koje taj učinak opaža.

std::counting_semaphore::acquire blokira dok uspješno atomski ne smanji pozitivan brojač. std::counting_semaphore::release atomski povećava brojač za update i odblokira čekatelje, uz preduvjet 0 <= update <= max() - counter. std::counting_semaphore::max vraća najveću podržanu vrijednost brojača, najmanje LeastMaxValue, a ne trenutačni broj dozvola.

LeastMaxValue mora biti nenegativan. Konstruktor zahtijeva 0 <= desired && desired <= max(), a release zahtijeva 0 <= update && update <= max() - counter; prekoračenje kapaciteta krši preduvjet. Objekt nije kopirljiv i uništavanje se ne smije natjecati s dretvama koje ga još koriste.

try_acquire() ne blokira, ali može lažno vratiti false i uz pozitivan brojač. Vremenske inačice mogu završiti nakon roka. Semafor prenosi dozvole; sam ne štiti proizvoljne podatke poput mutexa, pa zajedničko stanje i dalje zahtijeva ispravan sinkronizacijski protokol.

Primjeri

#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';
}

Rezultat

42

std::counting_semaphore → 42

Izvori