NNG_PIPE_LISTENER(3)

💖 NNG_PIPE_LISTENER 💖

okay bestie, gather round, because this is a lil function from the NNG Reference Manual that answers one very specific question and we're gonna slay it together ✨

---

✨ NAME ✨

nng_pipe_listener — return the listener that created a pipe 🎀

---

🦋 SYNOPSIS 🦋

#include <nng/nng.h>

nng_listener nng_pipe_listener(nng_pipe p);

---

🌸 DESCRIPTION 🌸

so. you've got a pipe. cute! iconic even. but like… who made you? 👀

The nng_pipe_listener() function returns the nng_listener that created the pipe p. it's giving "let me introduce you to your mother" energy and honestly we love that for you.

BUT. and this is the important part bestie, do not skip this — if the pipe was not created by a listener, then the returned value will have an identifier (nng_listener_id()) of -1. so like, -1 is basically the "no listener, no parents, orphan era, main character origin story" signal 💀. don't be out here calling nng_listener_id() on it and expecting a real one, iykyk.

---

👑 RETURN VALUES 👑

This function returns the listener that created the pipe, unless it was not created by a listener — in which case a value initialized with NNG_LISTENER_INITIALIZER will be returned. periodt. 💅

---

🙈 ERRORS 🙈

None. zero. nada. not a single one. no error codes, no drama, no tears. she simply returns. ate and left no crumbs 🍓

---

💜 SEE ALSO 💜

• nng_pipe(5)
• nng_listener(5)
• nng(7)

---

that's the whole page bestie, no cap, every detail intact, nothing skipped 🫶 go forth and check your pipes' parentage responsibly 💖

NNG_PIPE_LISTENER(3) — from the NNG Reference Manual, dated 2026-06-30 🌈 mwah, bye!! 🎀✨