NNG_HTTP_...LOC_ERROR(3http)

🎀 NAME 🎀

nng_http_res_alloc_error — allocate HTTP error response. This is the NNG_HTTP_...LOC_ERROR(3http) page from the NNG Reference Manual, bestie, and it's literally about making error responses the easy way ✨

🌸 SYNOPSIS 🌸

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

int nng_http_res_alloc_error(nng_http_res **resp, uint16_t status);

🦋 DESCRIPTION 🦋

Okay so nng_http_res_alloc_error() allocates a brand-new HTTP response structure and stores a pointer to it in resp. Iconic. 💅

That response comes initialized with:

• the status code status
• a corresponding reason phrase
• a simple HTML page containing the same information, generated and attached to the response

Relevant HTTP headers are set too, like Content-Type and Content-Length. The HTTP protocol version is also set to "HTTP/1.1" — periodt. 🔥

Tip: This is the simplest way to generate an error response. No cap, it's giving shortcut energy. 🫶

💖 RETURN VALUES 💖

This function returns 0 on success, and non-zero otherwise. That's it, bestie. ✨

🌈 ERRORS 🌈

• NNG_ENOMEM — insufficient free memory exists to allocate a message. 😭
• NNG_ENOTSUP — HTTP support not configured. 💀

🔗 SEE ALSO 🔗

• nng_http_res_alloc(3http)
• nng_http_res_free(3http)
• nng_http_res_set_reason(3http)
• nng_http_res_set_status(3http)
• nng_strerror(3)
• nng(7)

---

okay that's the whole page, bestie — from the NNG Reference Manual, dated 2026-01-13, page NNG_HTTP_...LOC_ERROR(3http). stay slay 💅✨