База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::counting_semaphore: ограничаване на едновременния достъп

std::counting_semaphore поддържа брой разрешения; acquire консумира едно, а release връща разрешения и може да отблокира чакаща нишка.

Версия: C++23

Синтаксис

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> от <semaphore> поддържа неотрицателен брояч. acquire() чака положителна стойност и атомарно я намалява; release(update) атомарно добавя update и отблокира чакащи. Ефектът на release силно предхожда успешно придобиване, което наблюдава този ефект.

std::counting_semaphore::acquire блокира, докато успешно намали атомарно положителен брояч. std::counting_semaphore::release увеличава атомарно брояча с update и разблокира чакащи, с предусловие 0 <= update <= max() - counter. std::counting_semaphore::max връща най-голямата поддържана стойност на брояча, поне LeastMaxValue, а не текущия брой разрешения.

LeastMaxValue трябва да е неотрицателно. Конструкторът изисква 0 <= desired && desired <= max(), а release изисква 0 <= update && update <= max() - counter; превишаването на капацитета нарушава предусловие. Обектът не се копира и унищожаването не бива да се състезава с нишки, които още го използват.

try_acquire() не блокира, но може лъжливо да върне false дори при положителен брояч. Времевите варианти могат да приключат след срока. Семафорът прехвърля разрешения; сам не защитава произволни данни като mutex, затова споделеното състояние изисква правилен протокол.

Примери

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

Резултат

42

std::counting_semaphore → 42

Източници