NNG_AIO_FINISH(3)

💖 NNG_AIO_FINISH(3) 💖

okay bestie, welcome to the NNG Reference Manual section on nng_aio_finish — this one's short but she is IMPORTANT, so pay attention, no skimming 🫶

---

✨ NAME ✨

nng_aio_finish — bestie, we are finishing an asynchronous I/O operation 🎀

---

✨ SYNOPSIS ✨

#include <nng/nng.h>

void nng_aio_finish(nng_aio *aio, int err);

---

✨ DESCRIPTION ✨

okay so nng_aio_finish() is the function that goes "this operation? done. finished. periodt." 💅 It marks the operation associated with aio as complete, with the status err. That status is literally the result that nng_aio_result() is gonna hand back to whoever's waiting. like, it's the whole point. 🦋

And bestie, it also causes the callback associated with the aio to be called. so like, the callback gets its moment. iconic behavior honestly ✨

Important 🚨 It is mandatory that operation providers call this function exactly once when they are finished with the operation. not twice, not zero times — exactly once. And after calling this function they must not perform any further accesses to the aio. like, that pointer? it's over for you. don't touch it. 🔥

Note 🌸 This function is only for I/O providers — the ones actually performing the operation, like HTTP handler functions or transport providers. ordinary users of the aio should not have any need for this function. so if you're just vibing with an aio as a regular user, this is not your girl. iykyk 😭

---

✨ RETURN VALUES ✨

None. literally nothing comes back. void. empty. a whole lot of nothing 💀

---

✨ ERRORS ✨

None. no errors to report, no codes to check, nothing to stress about 💖

---

✨ SEE ALSO ✨

• nng_aio_alloc(3)
• nng_aio_begin(3)
• nng_aio_cancel(3)
• nng_aio_defer(3)
• nng_aio_result(3)
• nng_aio(5)
• nng(7)

---

and that's the whole page bestie, you ate that 🍓 go forth and finish your async I/O operations exactly once, no cap 👑

💖 NNG Reference Manual · 2026-06-30 · mwah, love u, bye 💖