DC_BUFFER_NEW(3)

💖 DC_BUFFER_NEW(3) — like, the buffer origin story 💖

okay bestie, so this is a page from the Library Functions Manual for DC_BUFFER_NEW — yes the all-caps one, she's iconic like that 👑

---

✨ NAME ✨

dc_buffer_new — create an resizable binary buffer 🫶 (that's the whole job, and she does it well)

📚 LIBRARY 📚

you'll find this one hanging out in the library “libdivecomputer” — that's her home fr fr 💜

🎀 SYNOPSIS 🎀

okay so here's how you summon her:

#include <libdivecomputer/buffer.h>

dc_buffer_t *
dc_buffer_new(size_t capacity);

🌸 DESCRIPTION 🌸

so basically, dc_buffer_new creates a resizable binary buffer of initial size capacity — and yes, capacity may be zero, no cap, zero is a totally valid vibe ✨

but listen, bestie, this is important: the buffer you create must be freed with dc_buffer_free(3) when you're done. like, don't just abandon her, that's not the move 🙈

🔥 RETURN VALUES 🔥

she returns a pointer to a dc_buffer_t — or NULL on memory exhaustion 😭 (that's the "the system said no" outcome, and it's giving tragic but also very much possible)

🦋 SEE ALSO 🦋

• dc_buffer_free(3) — the one you need to call, remember? 💅

👑 AUTHORS 👑

the library “libdivecomputer” was written by Jef Driesen, jef@libdivecomputer.org 💖

and the manpages were written by Kristaps Dzonsons, kristaps@bsd.lv 🫶

---

and that's the whole page, bestie! go make your buffer, then go free your buffer. main character energy only 💅✨

🎀 Debian · January 5, 2017 🎀 — that's the source and the date, signin' off 💜🍓