Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::counting_semaphore: omezení souběžných přístupů

std::counting_semaphore udržuje počet povolení; acquire jedno spotřebuje a release povolení vrací a může odblokovat čekající vlákno.

Verze: C++23

Syntaxe

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žuje nezáporné počitadlo. acquire() čeká na kladnou hodnotu a atomicky ji sníží; release(update) atomicky přičte update a odblokuje čekající. Účinek release silně předchází úspěšnému získání, které tento účinek pozoruje.

std::counting_semaphore::acquire blokuje, dokud úspěšně atomicky nesníží kladný čítač. std::counting_semaphore::release atomicky zvýší čítač o update a odblokuje čekající, s předpokladem 0 <= update <= max() - counter. std::counting_semaphore::max vrací největší podporovanou hodnotu čítače, alespoň LeastMaxValue, nikoli aktuální počet povolení.

LeastMaxValue musí být nezáporné. Konstruktor vyžaduje 0 <= desired && desired <= max() a release vyžaduje 0 <= update && update <= max() - counter; překročení kapacity porušuje předpoklad. Objekt nelze kopírovat a destrukce nesmí soupeřit s vlákny, která jej stále používají.

try_acquire() neblokuje, ale může falešně vrátit false i při kladném počitadle. Časované varianty mohou skončit po termínu. Semafor předává povolení; sám nechrání libovolná data jako mutex, takže přístup ke sdílenému stavu stále potřebuje správný synchronizační protokol.

Pří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ýsledek

42

std::counting_semaphore → 42

Zdroje