fmt_pad(3)

✨ NAME ✨

fmt_pad — pad a string with spaces. that's it, that's the whole job, and she does it flawlessly 💅

🎀 SYNTAX 🎀

bestie, first you gotta invite her in:

#include <libowfat/fmt.h>

then the whole squad shows up like:

size_t fmt_pad(char *dest, const char *source,
      size_t srclen, size_t padlen,
      size_t maxlen);

🦋 DESCRIPTION 🦋

okay so picture this: you want your string to have main character energy and take up a lil more space than it naturally does. that's literally what fmt_pad is for 🫶

here's the tea. fmt_pad writes padlen-srclen spaces — only if that number is positive, so if you're out here asking for negative padding, nothing happens, no drama — and then it writes srclen characters from source. spaces first, string second, in that order, no cap.

now, the girl is disciplined. she truncates the output only if the length would exceed maxlen. that's the only reason she'll ever cut you off. respect.

and she returns the number of bytes she wrote. so you always know exactly how much she showed up for you.

💀 IMPORTANT: fmt_pad does not append \0. she is not null-terminating your string. she's not your therapist and she's not adding terminators. do that yourself, bestie, or you WILL be in your flop era.

and the iconic part — if dest equals FMT_LEN (i.e. is zero), fmt_pad returns the number of bytes it would have written. so you can vibe-check your sizing first, no actual writing, just a lil peek at what could've been. obsessed. ✨

👑 SEE ALSO 👑

the rest of the friend group, all equally iconic:

• fmt_strn(3)
• fmt_fill(3)

and that's the whole page, babe 🎀 fmt_pad(3), straight out of the Library Functions Manual — no version, no date, just timeless excellence, as she deserves. go pad something. slay. 💖🦋