std::counti...try_acquire(3)

💅 NAME 💅

okay so bestie, we’re in the C++ Standard Libary manual — yes, that’s literally how the header spells it, iconic — and this page is about std::counting_semaphore::try_acquire. The header title is std::counti...try_acquire(3) because terminal truncation said what it said 💀, and the NAME section just repeats std::counting_semaphore::try_acquire. No cap, that’s the whole name.

✨ SYNOPSIS ✨

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

It tries to atomically decrement the internal counter by 1 if it is greater than 0; no blocking occurs regardless. Literally zero blocking, even if it fails. 🦋

💖 RETURN VALUE 💖

true if it decremented the internal counter, otherwise false. That’s it. Periodt. 🔥

🧚 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. So bestie, spurious failure is a whole allowed vibe: even when the counter was greater than 0, an implementation can fail to decrement and hand you back false. 😭

👑 SEE ALSO 👑

• release — increments the internal counter and unblocks acquirers (public member function). 🫶
• acquire — decrements the internal counter or blocks until it can (public member function). 😭
• try_acquire_for — tries to decrement the internal counter, blocking for up to a duration time (public member function). ⏳
• try_acquire_until — tries to decrement the internal counter, blocking until a point in time (public member function). 🕰️

source/version sign-off: http://cppreference.com, dated 2024.06.10 — mwah, bestie 💋🎀