LOWDOWN_BUF_DIFF(3)

✨ LOWDOWN_BUF_DIFF(3) ✨

okay bestie, pull up a chair 💖 this one lives in the Library Functions Manual and it's serving from the liblowdown library. It's lowdown_buf — parse and diff Markdown buffers into formatted output. lowkey iconic. 🦋

🌸 LIBRARY 🌸

It's from library “liblowdown”, aka liblowdown. she's the moment. 👑

🎀 SYNOPSIS 🎀

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

int
lowdown_buf_diff(const struct lowdown_opts *opts, const char *new,
    size_t newsz, const char *old, size_t oldsz, char **ret,
    size_t *retsz);

💅 DESCRIPTION 💅

So the way this works is: it parses lowdown(5) buffers new (size newsz) and old (size oldsz), and it produces an edit script in ret of size retsz, all according to whatever configurations you put in opts. ✨

The script it gives you defines the differences from old to new. So like, old ➡️ new, that direction, no cap. 🫶

The output format? That's specified by opts->type. You pick the vibe, it delivers. 🌈

Not me forgetting this part — the caller is responsible for freeing ret. That's on you bestie, don't leak it. 😭

⭐ RETURN VALUES ⭐

• Returns zero on failure.
• Returns non-zero on success. 🎉

Failure happens from memory exhaustion. that's the whole reason, fr fr. 💀

🦋 SEE ALSO 🦋

• lowdown(3)

that's the whole page bestie, go slay 💖

this one was brought to you by the Debian girlies, dated $Mdocdate$, and filed under LOWDOWN_BUF_DIFF(3) — periodt. 👑💜