Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::counting_semaphore: ograniczanie liczby równoczesnych dostępów

std::counting_semaphore utrzymuje licznik pozwoleń; acquire zużywa pozwolenie, a release je zwraca i może odblokować oczekujący wątek.

Wersja: C++23

Składnia

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> przechowuje nieujemny licznik. acquire() czeka, aż licznik będzie dodatni, po czym atomowo go zmniejsza; release(update) atomowo dodaje update i odblokowuje oczekujących. Efekt release silnie poprzedza udane przejęcie, które ten efekt obserwuje.

std::counting_semaphore::acquire blokuje do skutecznego atomowego zmniejszenia dodatniego licznika. std::counting_semaphore::release atomowo zwiększa licznik o update i odblokowuje oczekujących, z warunkiem 0 <= update <= max() - counter. std::counting_semaphore::max zwraca największą obsługiwaną wartość licznika, co najmniej LeastMaxValue; nie zwraca bieżącej liczby pozwoleń.

Parametr LeastMaxValue musi być nieujemny. Konstruktor wymaga 0 <= desired && desired <= max(), a release wymaga 0 <= update && update <= max() - counter; przekroczenie pojemności narusza warunek wstępny. Obiekt nie jest kopiowalny, a destrukcja nie może ścigać się z używającymi go wątkami.

try_acquire() nie blokuje, lecz wolno mu fałszywie zwrócić false nawet przy dodatnim liczniku. Warianty czasowe mogą zakończyć się później niż podany termin. Semafor przekazuje pozwolenia, nie chroni sam danych jak mutex; dostęp do współdzielonego stanu musi wynikać z poprawnego protokołu synchronizacji.

Przykłady

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

Wynik

42

std::counting_semaphore → 42

Źródła