ZMQ_ATOMIC_COUNTER_S(3)

💅 zmq_atomic_counter_set(3) — the 0MQ Manual, bestie edition

okay so we're in the 0MQ manual and today's episode is zmq_atomic_counter_set(3), aka the girl whose whole job is just setting a number. no drama, no notes, she simply serves.

---

✨ NAME ✨

zmq_atomic_counter_set — set atomic counter to new value

---

🎀 SYNOPSIS 🎀

void zmq_atomic_counter_set (void *counter, int value);

that's it. that's the whole signature. short queen 👑

---

🦋 DESCRIPTION 🦋

so zmq_atomic_counter_set sets the counter to a new value, and it does it in a threadsafe fashion — meaning multiple threads can be doing their little thing and it's still gonna behave. no cap.

the largest value that is guaranteed to work across all platforms is 2^31-1. so like, stay in that lane, bestie, unless you enjoy chaos.

under the hood this function uses platform specific atomic operations. it's giving "I don't do the work myself, I delegate to the locals" and honestly? respect.

---

💜 RETURN VALUE 💜

zmq_atomic_counter_set() has no return value. it returns nothing. void. it says its piece and leaves. main character energy fr fr.

---

🌸 EXAMPLE 🌸

test code for atomic counters, here it is, verbatim, character for character, do not touch:

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;

look at her go — new counter, zero, increment up to 3, decrement back down, then zmq_atomic_counter_set (counter, 2) swoops in and just resets the vibe, and the decs pick up from there. ate. 🔥

---

🌈 SEE ALSO 🌈

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

the whole friend group, go say hi 🫶

---

👑 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. (yes, that's the real link, yes, it's a colon, no, I'm not editing it, it's not mine to edit 💀)

---

0MQ 4.3.5 · 10/09/2023 · that's the version and the date, babes — and that's the whole page. mwah 💋 zmq_atomic_counter_set(3) out. ✨