NNG_STREAM_DIALER_CLOSE(3str)

🌸 NAME 🌸

Okay so this is the NNG_STREAM_DIALER_CLOSE(3str) page from the NNG Reference Manual 💅✨ — and it's all about nng_stream_dialer_close, which closes a byte stream dialer. Short version: close byte stream dialer. Iconic.

✨ SYNOPSIS ✨

#include <nng/nng.h>

void nng_stream_dialer_close(nng_stream_dialer *d);

🦋 DESCRIPTION 🦋

The nng_stream_dialer_close() function closes the byte stream dialer you hand it as d — yes, d is the main character here 👑. It closes it, but does not free the underlying resources associated with it. That distinction is important, bestie: closing is not deallocating 🫶.

If any dial operations using d are in progress, they will be terminated with an NNG_ECLOSED error condition. RIP to those in-flight dials, they get the closed vibe check 😭.

Also: any future accesses to the dialer d will result in NNG_ECLOSED too. So once it's closed, it's closed — no sneaky comeback tour 🚫.

Note — This function does not release the memory for the dialer. So the application should still free the memory using nng_stream_dialer_free() once it is certain that nothing else is using it. Close first, free later, don't mix them up 💖.

💖 RETURN VALUES 💖

None. That's it. No return value, no drama. void really said “I have nothing to say” 💅.

💀 ERRORS 💀

None.

🌈 SEE ALSO 🌈

• nng_strerror(3)
• nng_stream_dialer_alloc(3str)
• nng_stream_dialer_dial(3str)
• nng_stream_dialer_free(3str)
• nng_stream_dialer(5)

xoxo, bestie 💖 this was the NNG Reference Manual, page NNG_STREAM_DIALER_CLOSE(3str), dated 2026-01-13. slay and happy closing ✨🎀