Skip to content

Search topics & cppreference

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

std::counting_semaphore<LeastMaxValue>::try_acquire

Tries to atomically decrement the internal counter by 1 if it is greater than 0 ; no blocking occurs regardless.

NotebookLM
bool try_acquire() noexcept;
(since C++20)

Tries to atomically decrement the internal counter by 1 if it is greater than ​0​; no blocking occurs regardless.

Return value

true if it decremented the internal counter, otherwise false.

Notes

Implementations are allowed to fail to decrement the counter even if it was greater than ​0​ - i.e., they are allowed to spuriously fail and return false.

See also

increments the internal counter and unblocks acquirers
(public member function)
decrements the internal counter or blocks until it can
(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.