NNG_HTTP_HANDLER_FREE(3http)

📦 version 1.11, in alpine 3.24

💅 NNG_HTTP_HANDLER_FREE (3http)

okay bestie, welcome to the nng_http_handler_free page from the NNG Reference Manual — yes, the whole manual is like this and yes, it's a lot, but we're gonna get through it together 🫶

✨ NAME ✨

nng_http_handler_free — free an HTTP server handler, i.e. the little cleanup moment where your handler gets to go home 🎀

✨ SYNOPSIS ✨

#include <nng/nng.h>
#include <nng/supplemental/http/http.h>

void nng_http_handler_free(nng_http_handler *h);

no return value, no drama, just vibes and a void. periodt 💅

✨ DESCRIPTION ✨

so the way that nng_http_handler_free() works is: it frees an allocated HTTP server handler. that's it. that's the whole job. it takes your handler h and releases it. iconic behavior, honestly 🌸

⚠️ important, and I mean it ⚠️ it is an error to free a handler that is registered with a server. like, do not do that. ngl that's the one rule here and it's lowkey non-negotiable 💀

and before you panic about forgetting to clean up: any handlers that are registered with servers are automatically freed when the server itself is deallocated. so the server handles its own business — main character energy 👑

🌈 RETURN VALUES 🌈

None. literally none. it returns nothing, it says nothing, it just does the thing ✨

💖 ERRORS 💖

None. zero errors reported. a peaceful little function. we love a low-maintenance icon 🎀

🦋 SEE ALSO 🦋

go read those too, iykyk 📚

okay that's the page!! sign-off time: this gem is from the NNG Reference Manual, dated 2026-01-13, and the footer was serving NNG_HTTP_HANDLER_FREE(3http) realness. take care of your handlers, don't free registered ones, and stay slay 🧚💜🔥

📦 where this page comes from