NNG_HTTP_RES_SET_REASON(3http)

💅 nng_http_res_set_reason — like, the reason-phrase setter, bestie

okay so this is from the NNG Reference Manual, and the function we're obsessing over today is nng_http_res_set_reason(3http). yes she's got the 3http section suffix and yes she's iconic for it 🎀

---

✨ NAME ✨

nng_http_res_set_reason — set the HTTP response reason 💬

---

🌸 SYNOPSIS 🌸

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

int nng_http_res_set_reason(nng_http_res *res, const char *reason);

like, two includes, one function, no cap 🫶

---

🦋 DESCRIPTION 🦋

so nng_http_res_set_reason() sets the human readable reason that's tied to the response res, and it sets it to reason. that's the whole vibe honestly ✨

and here's the cute part: if reason is NULL — which is literally the default — then a default reason phrase gets supplied for you, based on whatever the status code is (peep nng_http_res_set_status() for that one 👀).

💡 Tip: the reason is never parsed automatically, bestie. it's purely a hint for humans, to help them understand the nature of any erroneous result. it's giving "emotional support string" 😭

also important: a local copy of reason is made inside the response res. so like, your string gets duplicated, she's not holding a pointer to your business 🧚

---

💖 RETURN VALUES 💖

returns 0 on success, and non-zero otherwise. that's it, that's the whole check 🌈

---

💀 ERRORS 💀

• NNG_ENOMEM — insufficient memory to perform the operation. the allocator said no 🙈
• NNG_ENOTSUP — no support for HTTP in the library. like, HTTP isn't even a thing in this build, so, yeah 💀

---

👑 SEE ALSO 👑

• nng_http_res_alloc(3http)
• nng_http_req_get_reason(3http)
• nng_http_req_set_status(3http)
• nng(7)

---

and that's the page!! mwah 💋 this one's from the NNG Reference Manual, dated 2026-01-13 — go forth and set those reasons, bestie, periodt 🎀💜