LC_CTX_NEW(3)

💖 LC_CTX_NEW(3) — Librecast Programmer's Manual 💖

okay bestie, sit down, hydrate, and let's talk about the absolute foundation of everything Librecast: making a context and then, when you're done, letting it go. it's giving main character energy but make it memory management. 🦋

---

✨ NAME ✨

lc_ctx_new, lc_ctx_free — create and free Librecast contexts 🎀

📚 LIBRARY 📚

Librecast library (liblibrecast, -llibrecast) — yeah you gotta link it, no cap.

🌸 SYNOPSIS 🌸

#include <librecast/net.h>

lc_ctx_t *lc_ctx_new(void);
void lc_ctx_free(lc_ctx_t *ctx);

Compile and link with -llibrecast.

---

💅 DESCRIPTION 💅

so lc_ctx_new() is the moment. it creates a brand new Librecast context and sets up the environment for you. think of it as the getting-ready montage before the actual plot. once you're done with it, call lc_ctx_free(3) — that's not a suggestion, that's the law. 🫶

and lc_ctx_free()? it invalidates and frees a Librecast context that you made with lc_ctx_new(3). it's the graceful exit. the closing credits. ✨

🎯 RETURN VALUE 🎯

lc_ctx_new() hands you back a pointer to a lc_ctx_t handle. that's your baby now. 👑

but if things go sideways, it returns NULL and sets errno to ENOMEM. yes, that ENOMEM. 😭

the lc_ctx_free() function returns no value. literally nothing. it just does the thing and dips. 💀

💀 ERRORS 💀

lc_ctx_new() can fail with this one:

• ENOMEM — Out of memory. Possibly, the application hit the RLIMIT_AS or RLIMIT_DATA limit described in getrlimit(2). not me getting rate-limited by the kernel itself 🙈

🌈 EXAMPLE 🌈

Program source

lc_ctx_t *lctx;
lctx = lc_ctx_new();

/* your Librecast program here */

lc_ctx_free(lctx); /* free context when done */

see? create, do your lil thing, free. the whole cycle. iconic. 🌟

🔥 SEE ALSO 🔥

• lc_ctx_free(3)

---

and that's the whole page, bestie!! this lil gem came to you from the LIBRECAST crew, dated 2020-08-01, page LC_CTX_NEW(3) — stay hydrated, free your contexts, and slay 💖✨