NNG_DIALER_CLOSE(3)

💖 NNG_DIALER_CLOSE(3) — nng_dialer_close 💖

okay bestie, welcome to the NNG Reference Manual ✨ this one is short and sweet, no cap. it's about closing a dialer. that's it. that's the whole vibe. 🎀

---

🌸 NAME 🌸

nng_dialer_close — close dialer 👋

---

✨ SYNOPSIS ✨

#include <nng/nng.h>

int nng_dialer_close(nng_dialer d);

look at her. one include, one function call, one dialer. immaculate. 💅

---

🦋 DESCRIPTION 🦋

so the nng_dialer_close() function closes the dialer d. and not just d — it also closes any nng_pipe objects that have been created by that dialer. the whole friend group is leaving the party together, fr fr. 🚪✨

once this function returns, the dialer d and any of its resources are deallocated. like, gone gone. so it is an error to attempt to access d after this function has returned. do not do it. hands off. 🙈

⚠️ attempts to access d after it's been closed will result in NNG_ECLOSED errors. the door is locked, the lights are off, nobody's home. 💀

also lowkey important: dialers are implicitly closed when the socket they are associated with is closed. so if the socket dips, the dialer dips too. that's just how it is. 🫶

---

👑 RETURN VALUES 👑

this function returns 0 on success, and non-zero otherwise. classic. 💯

---

🌈 ERRORS 🌈

• NNG_ECLOSED — parameter d does not refer to an open dialer. it's giving "girl, that dialer is not real." 😭

---

🎀 SEE ALSO 🎀

• nng_close(3)
• nng_dial(3)
• nng_dialer_create(3)
• nng_strerror(3)
• nng_dialer(5)
• nng(7)

iykyk, go read those next, they're iconic too. 📚✨

---

and that's the page, bestie!! 🫶 written up for the NNG Reference Manual, dated 2026-06-30, filed under NNG_DIALER_CLOSE(3) — go close some dialers responsibly, mwah 💋