std::counting_semaphore<LeastMaxValue>::try_acquire

From cppreference.com
 
C++
 
Thread support library
Threads
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)(C++17)
this_thread namespace
(C++11)
(C++11)
(C++11)
(C++11)
Mutual exclusion
(C++11)
(C++11)
(C++17)
Generic lock management
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Condition variables
(C++11)
(C++11)
(C++11)
(C++11)
Semaphores
(C++20)(C++20)
Latches and barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
 
std::counting_semaphore
 
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

Exceptions

(none)

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.

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/thread/counting_semaphore/try_acquire&oldid=115855"