fmt_plusminus(3)

💖 fmt_plusminus(3) 💖

okay so bestie, we're in the Library Functions Manual and today's main character is fmt_plusminus — the tiniest, most unbothered little formatter in all of libowfat. she does ONE thing and she does it flawlessly. periodt. 👑

✨ NAME ✨

fmt_plusminus — write '+' or '-'

like... that's it. that's the whole job. and honestly? iconic.

🌸 SYNTAX 🌸

#include <libowfat/fmt.h>

size_t fmt_plusminus(char *dest,signed int source);

no cap, that's the whole signature. two args, one size_t back. we love a low-maintenance queen. 🫶

🦋 DESCRIPTION 🦋

okay so here's the vibe check. fmt_plusminus looks at source and writes exactly one character into dest:

• if source is negative → it writes '-' 💀
• if source is positive → it writes '+' ✨
• if source is neither (aka zero, aka the neutral icon) → it writes nothing at all 🙈

then it returns the number of bytes written. that's the return value, bestie, don't sleep on it.

heads up fr fr: fmt_plusminus does not append \0. no null terminator, no little goodbye note, nothing. if you were expecting a cute lil string ending you're gonna have to handle that yourself. 💅

and here's the fun part — if dest equals FMT_LEN (i.e. is zero), fmt_plusminus returns the number of bytes it would have written. it's giving "window shopping" energy. no actual writing happens, she's just telling you how much space she'd need. 🌈

⭐ SEE ALSO ⭐

• fmt_minus(3)
• scan_plusminus(3)

go read those too, iykyk, they're the friend group. 🎀

and that's the whole page, babe!! this was fmt_plusminus(3) from the Library Functions Manual — mwah, go format something cute, ily, bye!! 💖🦋🌸