std::latch::count_down(3)

✨ NAME ✨

okay so welcome to the C++ Standard Libary manual, bestie — this is the page for std::latch::count_down. yes, the name is literally std::latch::count_down, and it’s giving “tiny counter go brrr” energy. 💅

🌸 Synopsis 🌸

void count_down( std::ptrdiff_t n = 1 );  (since C++20)

okay so this icon atomically decrements the internal counter by n without blocking the caller. no waiting, no holding up the line, she just does the thing and keeps it moving. ✨

⚠️ bestie, listen: if n is greater than the value of the internal counter or is negative, the behavior is undefined. like 💀 do not do that. undefined behavior is not the vibe.

and this part is important: this operation strongly happens-before all calls that are unblocked on this latch. iykyk — that ordering is the whole point. 🔥

🎀 Parameters 🎀

• n — the value by which the internal counter is decreased. that’s it, that’s the parameter. 💖

⭐ Return value ⭐

(none) — literally nothing comes back, she’s not giving you a return value. 🫶

💅 Exceptions 💅

Throws std::system_error with an error code allowed for mutex types on error. so yeah, if something goes sideways, that’s the exception situation. periodt. 😭

source: http://cppreference.com · date/version: 2024.06.10 — mwah, go forth and count down responsibly 💜