Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::counting_semaphore<LeastMaxValue>::release

Atomically increments the internal counter by the value of update. Any thread(s) waiting for the counter to be greater than 0 , such as due to being blocked in acquire, will subsequently be unblocked.

NotebookLM
void release( std::ptrdiff_t update = 1 );
(since C++20)

Atomically increments the internal counter by the value of update. Any thread(s) waiting for the counter to be greater than ​0​, such as due to being blocked in acquire, will subsequently be unblocked.

This operation strongly happens before invocations of try_acquire that observe the result of the effects.

Preconditions

Both update >= 0 and update <= max() - counter are true, where counter is the value of the internal counter.

Parameters

update - the amount to increment the internal counter by

Exceptions

May throw std::system_error.

See also

decrements the internal counter or blocks until it can
(public member function)
tries to decrement the internal counter without blocking
(public member function)
tries to decrement the internal counter, blocking for up to a duration time
(public member function)
tries to decrement the internal counter, blocking until a point in time
(public member function)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.