NNG_HTTP_REQ_COPY_DATA(3http)

📦 version 1.11, in alpine 3.24

💖 NNG_HTTP_REQ_COPY_DATA(3http) 💖

okay bestie, welcome to the NNG Reference Manual — this is the NNG_HTTP_REQ_COPY_DATA(3http) page, and it's literally all about copying an HTTP request body. it's giving "set it and forget it" energy, no cap. 🫶

🌸 NAME 🌸

nng_http_req_copy_data — copy HTTP request body. that's the whole vibe. 💅

✨ SYNOPSIS ✨

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

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

🎀 DESCRIPTION 🎀

so nng_http_req_copy_data() makes a copy of body (of size size) and sets the HTTP body for the request req to it. the copy gets deallocated automatically when req is freed — no manual cleanup, periodt. ✨

when you send the request using nng_http_conn_write_req(), the copied body data will be automatically sent with it. yes bestie, it travels with the request. 🦋

this also updates the relevant Content-Length header of req. so the numbers stay cute and correct. 💖

📝 Note: the current framework does not support sending data via chunked transfer-encoding. so don't try to make fetch happen with chunked transfer-encoding, bestie 😭
✨ Tip: to avoid copying data, nng_http_req_set_data() may be used instead. that's the avoid-the-copy route, iykyk.
🎀 Tip: it is a good idea to also set the Content-Type header. do it for the vibe check — and because it's a good idea, duh. 💅

🫶 RETURN VALUES 🫶

this function returns 0 on success, and non-zero otherwise. slay when it's 0, side-eye when it's not. 😌

🚨 ERRORS 🚨

  • NNG_ENOMEM — insufficient memory to perform the operation. your RAM said "not today" 😭
  • NNG_ENOTSUP — no support for HTTP in the library. HTTP is not in this library's group chat, fr fr 💀

🔗 SEE ALSO 🔗

xoxo, your fave manual page 💅 — from the NNG Reference Manual, dated 2026-01-13, page NNG_HTTP_REQ_COPY_DATA(3http). periodt. 🦋

📦 where this page comes from