NNG_PIPE_DIALER(3)

💖 NAME 💖

nng_pipe_dialer — bestie, this is the one that hands you back the dialer that created a pipe 🫶

---

✨ SYNOPSIS ✨

#include <nng/nng.h>

nng_dialer nng_pipe_dialer(nng_pipe p);

---

🌸 DESCRIPTION 🌸

okay so. nng_pipe_dialer() is literally the "who's your parent" function for pipes. you pass it a pipe p, and it gives you back the nng_dialer that created that pipe. icon behavior, no cap 💅

but here's the plot twist 👀 — if the pipe was not created by a dialer, then the value you get back will have an identifier (that's what nng_dialer_id() gives you) of -1. so if you see a -1 in there, that pipe did not come from a dialer, periodt.

🧚 careful bestie — a -1 id is the clue that there's no dialer behind this pipe, so don't go treating that returned value like a real dialer!

---

🔥 RETURN VALUES 🔥

so what do you actually get? this function returns the dialer that created the pipe. easy, slay. 💖

unless the pipe was not created by a dialer — in that case, you get back a value initialized with NNG_DIALER_INITIALIZER. that's the "nobody's home" version of a dialer, and it's giving placeholder energy 🙈

---

💀 ERRORS 💀

None. literally none. zero. not a single one. this function does not fail on you, and that's the vibe check passing ✅✨

---

👑 SEE ALSO 👑

• nng_pipe(5)
• nng_dialer(5)
• nng(7)

---

made with love by the NNG Reference Manual crew 🎀 this page is from the 2026-06-30 drop, NNG Reference Manual edition — go off, and remember: -1 means no dialer, iykyk 💜🦋