ZMQ_ATOMIC_COUNTER_I(3)

💅 ZMQ_ATOMIC_COUNTER_I(3) — bestie edition ✨

okay so this is a page from the 0MQ manual (you know, the ZeroMQ girlies) and it's about ONE tiny little function that does ONE tiny little thing, but it does it flawlessly under pressure. main character energy fr. let's get into it 🫶

---

✨ NAME ✨

zmq_atomic_counter_inc — bestie, it increments an atomic counter. that's the whole job. she's simple, she's iconic, she's booked and busy. 💖

---

🌸 SYNOPSIS 🌸

int zmq_atomic_counter_inc (void *counter);

literally one function. one arg. no drama. we love a low-maintenance queen. 👑

---

🦋 DESCRIPTION 🦋

so the zmq_atomic_counter_inc function increments an atomic counter in a threadsafe fashion. yes, threadsafe — meaning multiple threads can be fighting over this counter at the same time and she will NOT fumble. not on her watch. 🙈

and how does she pull that off? this function uses platform specific atomic operations. so like, she's not doing anything sketchy or hand-wavy — she's using whatever the underlying platform gives her that's actually atomic. no cap. 💅

---

💜 RETURN VALUE 💜

the zmq_atomic_counter_inc() function returns the old value of the counter, before incrementing.

read that again bestie. the OLD value. not the new one. not the value plus one. the value before she did the thing. this trips people up EVERY time and it's giving "gotcha" energy, so clock it now. ⭐

---

🎀 EXAMPLE 🎀

test code for atomic counters. look at this little glow-up arc — she starts at 0, climbs to 3, dips down, gets set, dips again, and then gets destroyed. growth, then closure. very demure. very mindful. 🌈

void *counter = zmq_atomic_counter_new ();
assert (zmq_atomic_counter_value (counter) == 0);
assert (zmq_atomic_counter_inc (counter) == 0);
assert (zmq_atomic_counter_inc (counter) == 1);
assert (zmq_atomic_counter_inc (counter) == 2);
assert (zmq_atomic_counter_value (counter) == 3);
assert (zmq_atomic_counter_dec (counter) == 1);
assert (zmq_atomic_counter_dec (counter) == 1);
assert (zmq_atomic_counter_dec (counter) == 0);
zmq_atomic_counter_set (counter, 2);
assert (zmq_atomic_counter_dec (counter) == 1);
assert (zmq_atomic_counter_dec (counter) == 0);
zmq_atomic_counter_destroy (&counter);
return 0;

notice how every inc returns the value from before it incremented?? that's the whole point of the RETURN VALUE section bestie, i TOLD you. 😭

---

🔥 SEE ALSO 🔥

her whole friend group, her squad, her support system — go read these too:

• zmq_atomic_counter_new(3)
• zmq_atomic_counter_set(3)
• zmq_atomic_counter_dec(3)
• zmq_atomic_counter_value(3)
• zmq_atomic_counter_destroy(3)

iykyk. the whole atomic counter cinematic universe. 💀✨

---

👑 AUTHORS 👑

this page was written by the 0MQ community. to make a change please read the 0MQ Contribution Policy at http://www.zeromq.org/docs:contributing.

like yes, contribute bestie, the community WANTS you, go be part of the lore. 🫶

---

and that's the whole page! 💖 this one's from 0MQ 4.3.5, dated 10/09/2023 — so she's a little vintage but she still eats. periodt. 🍓🧚⭐