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