fmt_humank(3)

✨ fmt_humank ✨

okay bestie, sit down, hydrate, because this one is adorable and you're gonna use it literally every day 💖

🎀 NAME 🎀

fmt_humank — write a human readable ASCII representation of a long integer

🦋 SYNTAX 🦋

#include <libowfat/fmt.h>

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

🌸 DESCRIPTION 🌸

so here's the vibe: fmt_humank writes a human readable ASCII representation of source to dest, and then it hands you back the number of bytes it wrote. that's the whole thing. she's simple, she's elegant, she ate 💅

the result looks like the file size output of ls -h, no cap:

• 1024 becomes "1.0k"
• 1048576 becomes "1.0M"
• and so on for "G" and "T" 🔥

one thing to know: fmt_humank does not append \0. nope. not even a little. it writes the digits and dips, so if you need a null terminator that's a you problem, bestie 😭

and if dest equals FMT_LEN (i.e. is zero), then fmt_humank returns the number of bytes it would have written. it's giving "window shopping" energy — you get the size without the actual output 🙈

also, the output of fmt_humank can not exceed 11 (assuming unsigned long long has 64 bits). so budget for that and you're golden 👑

👑 SEE ALSO 👑

• fmt_human(3)
• scan_humank(3)

and that's the whole page, fr fr 🫶 this little icon lives in the Library Functions Manual and she's fmt_humank(3) through and through — go format something pretty with her 🌈✨🎀