NNG_CV_ALLOC(3supp)

🎀 NNG_CV_ALLOC(3supp) — allocate condition variable 🎀

okay bestie, welcome to the NNG_CV_ALLOC(3supp) page from the NNG Reference Manual — it's giving “tiny but important,” and we're gonna get you across it. 💖

---

✨ NAME ✨

nng_cv_alloc — allocate condition variable

🫶 SYNOPSIS 🫶

#include <nng/nng.h>

typedef struct nng_cv nng_cv;

int nng_cv_alloc(nng_cv **cvp, nng_mtx *mtx);

💅 DESCRIPTION 💅

So nng_cv_alloc() allocates a condition variable, uses the mutex mtx, and hands it back to you in cvp. That's the whole assignment, no cap. ✨

Every condition variable is associated with a mutex, bestie — and that mutex must be owned when a thread waits for the condition using nng_cv_wait() or nng_cv_until(). The mutex must also be owned when signaling the condition using the nng_cv_wake() or nng_cv_wake1() functions. 👑

okay so ownership of that mutex is not optional — it's the main character rule here. 🚨

🌈 RETURN VALUES 🌈

This function returns 0 on success, and non-zero otherwise. Slay. ✅

💀 ERRORS 💀

• NNG_ENOMEM — insufficient free memory exists. 😭

👀 SEE ALSO 👀

• nng_cv_free(3supp)
• nng_cv_until(3supp)
• nng_cv_wait(3supp)
• nng_cv_wake(3supp)
• nng_cv_wake1(3supp)
• nng_mtx_alloc(3supp)
• nng_strerror(3)
• nng(7)

---

and that's the page, bestie 🎀✨ — from the NNG Reference Manual, source/version and all, dated 2026-01-13, page NNG_CV_ALLOC(3supp). mwah 💋