fmt_fill(3)

💖 fmt_fill(3) 💖

okay bestie, so this is a page from the Library Functions Manual, and it's literally about fmt_fill — the little icon that pads your string with spaces. no cap, it's giving "quietly carrying the whole alignment situation." let's get into it 🫶

✨ NAME ✨

fmt_fill — append spaces to a string 🌸

🎀 SYNTAX 🎀

#include <libowfat/fmt.h>

size_t fmt_fill(char *dest,
      size_t srclen, size_t padlen,
      size_t maxlen);

like, that's the whole vibe. five args, one job 💅

🦋 DESCRIPTION 🦋

so fmt_fill appends padlen-srclen spaces to dest — but only if that number is positive, bestie. if it's not positive, it's not doing that. math is math. 🧚

dest is holding srclen bytes when you hand it over, okay? that's the situation it's working with.

it truncates the output only if the length would exceed maxlen. that's the only time. it's not out here truncating for fun. 👑

it returns the number of bytes it wrote. count them. slay. ✨

🚨 important: fmt_fill does not append \0. it is not writing your null terminator for you. do not come for her about it. she simply does not do that.

and here's the iconic little plot twist: if dest equals FMT_LEN (i.e. is zero), fmt_fill returns the number of bytes it would have written. not wrote. would have. it's manifesting the byte count. no cap. 💀

👑 SEE ALSO 👑

• fmt_strn(3)
• fmt_pad(3)

go read those too, iykyk 🌈

and that's the whole page, fr fr 💜 shoutout to the Library Functions Manual for hosting this legend, and to fmt_fill(3) itself — no date stamp on this one bestie, just vibes and a page number. periodt. 🎀✨