NNG_HTTP_REQ_SET_DATA(3http)

💅 nng_http_req_set_data(3http) 💅

okay bestie, so this one is from the NNG Reference Manual — it's nng_http_req_set_data(3http) and it's honestly such a vibe. Let's get into it 🫶

---

✨ NAME ✨

nng_http_req_set_data — set HTTP request body 🌸

---

🎀 SYNOPSIS 🎀

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

int nng_http_req_set_data(nng_http_req *req, const void *body, size_t size);

---

💖 DESCRIPTION 💖

so nng_http_req_set_data() literally sets the HTTP body that belongs to the request req to body, and the size of that body to size. like, no cap, that's the whole job 💅

and then — this is the slay part — that body data gets automatically sent with the request when it's sent using nng_http_conn_write_req(). iconic behaviour, honestly 👑

it ALSO updates the relevant Content-Length header of req. the way it just handles that for you?? main character energy fr ✨

⚠️ Note — heads up bestie: the current framework does not support sending data via chunked transfer-encoding. so like, don't come for it, it's just not that girl yet 💀

now, important thing, i need you to hear me on this one: the body is not copied 🚨 so you (the caller) must ensure that it stays available until the req is deallocated. like keep it alive, bestie, don't let it ghost you 🙈

🧚 Tip — if you want a local copy allocated with req that gets automatically deallocated when req is freed, go look at nng_http_req_copy_data(). she does the copying for you 💜

🦋 Tip — it is a really good idea to also set the Content-Type header. like, strongly recommend. do it. periodt. 🎀

---

⭐ RETURN VALUES ⭐

this function returns 0 on success, and non-zero otherwise. that's it, that's the contract 😌

---

🔥 ERRORS 🔥

• NNG_ENOMEM — insufficient memory to perform the operation 😭 (she ran out of room, it happens)
• NNG_ENOTSUP — no support for HTTP in the library 💀 (the library said "not today")

---

🌈 SEE ALSO 🌈

• nng_http_conn_write_req(3http)
• nng_http_req_alloc(3http)
• nng_http_req_copy_data(3http)
• nng_http_req_set_header(3http)
• nng(7)

---

okay that's the whole page, you ate that 🍓 go set some request bodies and be the icon you are 💖

— with love, from the NNG Reference Manual, dated 2026-01-13, version of NNG_HTTP_REQ_SET_DATA(3http) ✨💅🫶