ZMQ_MSG_INIT_BUFFER(3)

💖 ZMQ_MSG_INIT_BUFFER(3) 💖

okay bestie, welcome to the 0MQ Manual ✨ this is the page for zmq_msg_init_buffer, and it's literally the glow-up your message needs. sit down, hydrate, let's go 🫶

---

🌸 NAME 🌸

zmq_msg_init_buffer — initialise a 0MQ message with a copy of a buffer 💅

---

✨ SYNOPSIS ✨

int zmq_msg_init_buffer (zmq_msg_t *msg, const void *buf, size_t size);

---

🎀 DESCRIPTION 🎀

so the way that zmq_msg_init_buffer() works is: it shall allocate every resource it needs to store a message that's size bytes long, and then it initialises the message object that msg points to so it represents a copy of the buffer that the buf and size arguments are pointing at. copy, not borrow. she's her own girl 💖

and the implementation gets to choose for itself whether it stores the message content on the stack (for small messages) or on the heap (for large messages). it's giving "trust the implementation, she knows her limits" ✨

⚠️ Caution — never ever access zmq_msg_t members directly. like, not even once. always use the zmq_msg family of functions instead. no peeking under the hood, bestie 🙈

⚠️ Caution — the functions zmq_msg_init(), zmq_msg_init_data(), zmq_msg_init_buffer() and zmq_msg_init_buffer() are mutually exclusive. never initialise the same zmq_msg_t twice. fr fr. double-initialising is not the vibe, it's a whole situation 💀

---

🌈 RETURN VALUE 🌈

zmq_msg_init_buffer() shall return zero if everything's cute and successful. otherwise it shall return -1 and set errno to one of the values listed below. she will tell you what went wrong, you just gotta listen 👑

---

🦋 ERRORS 🦋

• ENOMEM — insufficient storage space is available. like, there is simply no room, the closet is full, we cannot make it work 😭

---

👑 SEE ALSO 👑

zmq_msg_init_data(3) zmq_msg_init_size(3) zmq_msg_init(3) zmq_msg_close(3) zmq_msg_data(3) zmq_msg_size(3) zmq(7)

---

💜 AUTHORS 💜

this page was written by the 0MQ community 🫶 and if you wanna make a change, please read the 0MQ Contribution Policy at http://www.zeromq.org/docs:contributing. they'd love to have you, no cap 💅

---

0MQ 4.3.5 · 10/09/2023 · that's the whole page bestie, mwah 💖✨🎀🦋🌸