fmt_human(3)

💖 fmt_human(3) 💖

okay bestie, welcome to the Library Functions Manual, section 3, where we talk about fmt_human — she's a little function with big main character energy, and yes, she lives in the library functions girlies. let's get into it 🫶

✨ NAME ✨

fmt_human — writes a human readable ASCII representation of a long integer. literally her whole job. iconic of her tbh 💅

🌸 SYNTAX 🌸

#include <libowfat/fmt.h>

size_t fmt_human(char *dest,unsigned long long source);

copy it exactly, no notes, she's perfect as is 😌

🦋 DESCRIPTION 🦋

so basically, fmt_human takes your source (a long integer, but make it cute) and writes a human readable ASCII representation of it into dest. then she tells you how many bytes she wrote, by returning that number. no cap.

the result is giving major "file size output of ls -H" vibes. like:

• 1000 becomes "1.0k" ✨
• 1000000 becomes "1.0M" ✨
• and so on and so on for "G" and "T" 🎀

one thing to know, and this is important, bestie: fmt_human does not append \0. she's not gonna null-terminate that string for you. she said figure it out 💀

now, if dest equals FMT_LEN (i.e. it is zero), then fmt_human won't write anything — instead she just returns the number of bytes she would have written. so you can ask her "hey how big would this be" and she'll tell you, no actual writing required. queen behaviour fr fr 👑

also, heads up: the output of fmt_human can not exceed 11 bytes (that's assuming unsigned long long has 64 bits). so don't come for her with a buffer smaller than that, mwah 💋

🔥 SEE ALSO 🔥

• fmt_humank(3)
• scan_human(3)

go read those too, they're her besties, the friend group is immaculate 🌈

sign-off time, babe 💜 this little love letter came from the Library Functions Manual and it's all about fmt_human(3). that's the whole page, you ate it up, mwah 🎀✨