NNG_AIO_CANCEL(3)

💖 nng_aio_cancel — cancel asynchronous I/O operation 💖

okay bestie so this is nng_aio_cancel from the NNG Reference Manual, and she's literally the ✨girlboss✨ of "never mind, stop that" 💅

---

✨ SYNOPSIS ✨

#include <nng/nng.h>

void nng_aio_cancel(nng_aio *aio);

like look at her. clean. simple. no return value. iconic. 👑

---

🌸 DESCRIPTION 🌸

okay so here's the tea 🍓 — nng_aio_cancel() aborts an operation that you previously started with the handle aio.

and when the operation actually gets aborted? the callback for that handle gets called 📞, and nng_aio_result() will come back handing you the error NNG_ECANCELED. so fr fr, you'll know.

now — and this part is important, don't skip it — this function does not wait around for the operation to be fully aborted. she does not sit there tapping her acrylics waiting for closure. she returns immediately. 🏃♀️💨 she said "I sent the text, I'm moving on."

and if there's no operation currently in progress? like, either it already finished, or you never started one in the first place? then this function just... has no effect. nothing. zip. it's giving "hey bestie are you okay" "yeah I just have nothing to cancel" 💀

Note 🙈 — this function is the same as calling nng_aio_abort() with the error NNG_ECANCELED. same energy, different name, they're twins 👯♀️

---

🎀 RETURN VALUES 🎀

None.

nothing. it's void. she gives you no receipts, no nothing. 🫶

---

🦋 ERRORS 🦋

None.

zero errors. cannot fail. cannot be stopped (except the operation itself, which is literally the point). slay. ✨

---

🌈 SEE ALSO 🌈

• nng_aio_abort(3)
• nng_aio_alloc(3)
• nng_aio_result(3)
• nng_aio(5)
• nng(7)

go read those too, bestie, iykyk 💜

---

and that's a wrap on this page from the NNG Reference Manual, dated 2026-06-30 🌸 mwah, take care of yourself, hydrate, and cancel those async ops with confidence. periodt. 💅✨👑