NNG_CTX_CLOSE(3)

nng_ctx_close(3) — the NNG Reference Manual page where we say bye-bye to a context 🎀

okay bestie, gather round, because today we're learning how to close a context in NNG and honestly it's giving closure (literally) 💅

---

✨ NAME ✨

nng_ctx_close — close context 🫶

---

✨ SYNOPSIS ✨

#include <nng/nng.h>

int nng_ctx_close(nng_ctx ctx);

like, that's it. one function, one argument, iconic behavior 👑

---

✨ DESCRIPTION ✨

so nng_ctx_close() closes the context ctx. that's the whole vibe. 💖

but wait — plot twist — messages that have already been submitted for sending may be flushed or delivered, and whether that happens depends on the transport. so no, this isn't a "cancel everything instantly" button, it's more of a "we're wrapping up here" moment. no cap. 😌

after this call returns, if you try to use that context again? boom, you get NNG_ECLOSED. every time. it's over, babe. 💀

and threads that were waiting on operations on the context at the moment this call runs may also come back with an NNG_ECLOSED result. so yeah, everyone's getting the news at the same time. group chat announcement energy fr fr 📣

Note 🫧 closing the socket that's associated with ctx (as in, using nng_close()) also closes this context. so the context goes down with the ship. 🌊

---

✨ RETURN VALUES ✨

• 0 on success — slay 💚
• non-zero otherwise — not slay 😭

---

✨ ERRORS ✨

• NNG_ECLOSED — the context ctx is already closed or was never opened in the first place. she's gone, or she never existed. either way, nothing to close here bestie 🦋

---

✨ SEE ALSO ✨

• nng_ctx_open(3)
• nng_strerror(3)
• nng_ctx(5)
• nng(7)

---

and that's the page!! this was the NNG Reference Manual, dated 2026-06-30, and honestly? obsessed. go close your contexts responsibly, besties 💜✨