vrb_put_all(3)

💖 vrb_put_all(3) 💖

okay so bestie, this is vrb_put_all(3) from the VRB Programmer’s Manual, and it’s giving “put all the data into a VRB or don’t bother” energy 💅✨

---

🌸 NAME 🌸

vrb_put_all — put all data into a VRB

---

📚 LIBRARY 📚

Link with -lvrb, obviously 🫶

---

✨ SYNOPSIS ✨

#include <vrb.h>

int vrb_put_all(vrb_p vrb, char *source, size_t size);

---

💫 DESCRIPTION 💫

vrb_put_all puts caller provided data into a virtual ring buffer only if all the data will fit.

Like, it’s not doing the “maybe a little bit fits” thing. It’s all-or-nothing, and that’s iconic 💅

---

🎀 ARGUMENTS 🎀

• vrb_p vrb — specifies which virtual ring buffer we’re talking about, bestie.
• char *source — specifies the location where to copy the data from.
• size_t size — specifies the length of data provided by the caller.

---

⭐ RETURN VALUE ⭐

• int — if the data fits and is copied, 0 is returned; otherwise -1 is returned.

So yeah: 0 is the slay, -1 is the “nope” 💀

---

🔥 ERRORS 🔥

If an error is returned, then errno will have one of the following values:

• EINVAL — an invalid virtual ring buffer pointer was specified. That pointer is not it, fr fr 🙈
• ENOSPC — the virtual ring buffer does not have enough space to hold all of the data. No room, no slay 😭

---

🦋 SEE ALSO 🦋

vrb(3), vrb_capacity(3), vrb_data_len(3), vrb_data_ptr(3), vrb_destroy(3), vrb_get(3), vrb_get_min(3), vrb_give(3), vrb_init(3), vrb_init_opt(3), vrb_is_empty(3), vrb_is_full(3), vrb_is_not_empty(3), vrb_is_not_full(3), vrb_move(3), vrb_new(3), vrb_new_opt(3), vrb_put(3), vrb_read(3), vrb_read_min(3), vrb_resize(3), vrb_space_len(3), vrb_space_ptr(3), vrb_take(3), vrb_uninit(3), vrb_write(3), vrb_write_min(3)

---

xoxo, source/version vrb, dated 2002-09-30 — bye bestie 💖