LOWDOWN_LATEX_FREE(3)

💅 LOWDOWN_LATEX_FREE(3) — the "okay we're DONE here" page 💅

liblowdown girlies, this one's for you 🫶 it's a manual page from the Library Functions Manual section, and lowkey it's the shortest bop in the whole library. Let's get into it.

✨ NAME ✨

lowdown_latex_free — bestie, it frees a Markdown LaTeX renderer 💖

📚 LIBRARY 📚

library “liblowdown” 🎀 (yes the quotes are part of the vibe, keep 'em)

🌸 SYNOPSIS 🌸

#include <sys/queue.h>
#include <stdio.h>
#include <lowdown.h>

void
lowdown_latex_free(void *arg);

Like, that's it. One function. One argument. Clean. Minimal. Iconic ✨

💅 DESCRIPTION 💅

Okay so picture this: you made a LaTeX renderer earlier with lowdown_latex_new(3) (we love her, she ate) and now you're done with her and you need to let her go 😭.

That's literally what lowdown_latex_free does. It frees the LaTeX renderer that was created with lowdown_latex_new(3).

And bestie, listen — if arg is NULL? The function does nothing. No crash, no drama, no tears. Just peace 🕊️. She's not gonna yell at you for passing nothing. That's main character energy fr fr.

⚠️ reminder: this is your cleanup step, so don't skip her! Freeing things you allocated is the bare minimum and it's giving responsible 💜

🔥 EXAMPLES 🔥

Okay so here's the whole little glow-up routine: we parse b of length bsz and output in LaTeX format. No cap, this is the full pipeline, from "hello new doc" all the way to "bye renderer" 🌈

struct lowdown_buf *out;
struct lowdown_doc *doc;
struct lowdown_node *n;
void *rndr;

if ((doc = lowdown_doc_new(NULL)) == NULL)
        err(1, NULL);
if ((n = lowdown_doc_parse(doc, NULL, b, bsz, NULL)) == NULL)
        err(1, NULL);
if ((out = lowdown_buf_new(256)) == NULL)
        err(1, NULL);
if ((rndr = lowdown_latex_new(NULL)) == NULL)
        err(1, NULL);
if (!lowdown_latex_rndr(out, rndr, n))
        err(1, NULL);

fwrite(out->data, 1, out->size, stdout);

lowdown_latex_free(rndr);
lowdown_buf_free(out);
lowdown_node_free(n);
lowdown_doc_free(doc);

Look at that teardown block at the bottom though 😩💖 Every single thing that got made gets freed, in the correct order, and lowdown_latex_free(rndr) is right there leading the charge. That's what we call a clean exit, periodt. ✨

👀 SEE ALSO 👀

• lowdown(3)
• lowdown_latex_new(3)

and that's the whole page, bestie, we're done here 💀✨

This little love letter comes to you from Debian, stamped $Mdocdate$, and filed under LOWDOWN_LATEX_FREE(3). Free your renderers, hydrate, and stay iconic 👑🦋🌸